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, | MANUAL OVERVIEW 


If you have had previous experience using other text editors or 
word processors on the Macintosh, you will probably find that 
using QUED/M is both easy and intuitive. As such, you may 
find that there is little need to read this manual. If this occurs, 
feel free to look over the various menu items and go ahead and 
try out any features that seem intriguing. Section 11 (Menu 
and Command Listings) provides a quick reference on how to 
use specific features, 


For experienced Macintosh users Sections 6 (on Regular 
Expressions), 8 and 9 (on QUED/M Macros) provide a 
thorough introduction to the use and operation of QUED/M's 
powerful and unique facilities, 


QUED/M closely follows the standard Macintosh interface. In 
writing this manual we assume that you already have some 
experience with using Macintosh applications. If you do not yet 
feel comfortable with basic operations such as choosin g Menu 
items, selecting text, scrolling and resizing windows, we 
recommend reviewing your Macintosh manual. It is also helpful 
to use the “Tour of the Macintosh” Program, which accompanies 
the Macintosh manual. These should give you the background 
necessary for using QUED/M. 


Section 1 covers Starting up the QUED/M program. 


Sections 2 through 6 describe the special features of QUED/M 
in detail. 


Section 7 covers Regular Expressions and can be omitted on 


Section 8 shows how to use QUED/M's Macros in realistic 
applications. 


Section 9 describes how you can program your own macros. 
This section will prove challenging to beginning computer users. 


Section 10 lists the Single character arguments, such as Find 
and Change that are used with macro commands. 
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Section 11 provides a list of all the menu items in the order 
they appear on the menu bar, along with an explanation of each 
item’s function. You will find it useful to have this section open 
for reference while learning to use QUED/M. 


Section 12 lists the keyboard shortcuts. These include 
keyboard substitutes for mouse movements, keyboard 
equivalents for menu and dialog items, and other commands not 
found elsewhere in this manual. 


Notation 
Throughout the QUED/M program and manual, we use the 
following symbols to represent the modifier keys: 


# = Command key (also called the Apple key) 
@ = Shift key 
€ = Option key 


Thus the notation: 


9% @ €Enter 


means that the three modifier keys (Shift, Command, and 
Option) were being held down when the Enter key was hit. 


IMPORTANT: In QUEDIM and in this manual, the € 
symbol refers to the Option key, not the Command key. Newer 
Macintosh keyboards label the Command key with both the € 
and # symbols, but in QUED/M the Command key is always 
represented by the # character. 


These special symbols are also used in macros to designate the 
modifier keys. They are entered automatically for you during 
macro recording. They can also be entered from the ENTER 
ASCII window, which can be located via the special menu to the 
left of the Macros menu. 


To help you find the modifier symbols in the ENTER ASCII 
window, here are their codes in Hex and Decimal: 


ToooononnaAnnaogogog 


3 


Symbol Hex Dec Key Pressed 


3 11 017 Command symbol 
é 14 020 Option symbol 
° 13 019 Shift 


The ENTER ASCII window is described further in Section 
he 


These symbols are only visible in QUEDIM while using the 
Chicago font. In other fonts they appear as the default character, 
a small rectangular box. 


.4 
2 INTRODUCTION 


WHAT IS QUED/M™? 

QUED/M, pronounced "kwed-em", is a text file editor. It can 
make just about any task that requires entering, editing, and 
retrieving text easier to complete. 


QUED/M is not a word processor. Unlike programs such as 
MacWrite, it is not designed to support elaborate formatting of 
individual words or the inclusion of pictures into a document. 
You will find that for most writing jobs, typing and editing text 
is faster and easier with QUED/M than with word processing 
programs, and that text can be effortlessly transferred from 
QUED/M to a word processing or page layout program for final 
formatting. 


QUED/M is not an outlining program. The ease of entering and 
editing text, however, which QUED/M offers, along with its 
block formatting and hiding capabilities, makes having a 
separate program for outlining and “idea processing” 
unnecessary. 


The powerful Macro and Regular Expression matching features 
of QUED/M allow you to store, manipulate, and retrieve large 
amounts of information quickly, without the restrictions 
imposed by data base programs. You can therefore use it to 
manage your text data base. 


Here are some of the things you can do with QUED/M: 


Write Programs 

QUED/M has all the features you ever wanted in a program 
editor... and more. You can create custom macros, which will 
perform often repeated tasks in one keystroke. Invisible markers 
help you move quickly between different parts of a long, 
complicated program. QUED/M can count the number of times a 
variable name is used. You can define your own “parentheses” 
and have QUED/M check to be sure that they are all properly 
closed. The total available memory is displayed at all times so 
that you can easily monitor memory usage. QUED/M’s 
extensive formatting features encourage the user to write 
programs that can be easily read by both compilers and people. 
The text hiding feature allows you to outline a program and 
observe its flow both on the screen and after it has been printed. 
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Write Documentation 

Outlining features help to organize your documentation. You can 
write your Own macros to extract a list of all procedure names, 
variable declarations, or other key elements of a program or text. 
Creating and sorting lists of Macintosh file names is also 
straightforward. 


Simplify Telecommunications 

QUED/M helps you prepare text for transfer to mainframes and 
bulletin boards. You can type your text with automatic word 
wrap set, and then, before sending it to another computer, have 
QUED/M break the lines automatically with explicit Returns. 
he can also easily replace tabs with spaces and spaces with 
tabs. 


Clean up Files 

QUED/M can “Zap Gremlins” from text files, to remove nulls 
and other peculiar illegal characters that cause problems for 
computer networks and peripherals. You can create custom 
macros to selectively filter all unwanted characters or words 
from your files. 


Edit Postscript Files 

The Show ASCII and Show Invisibles options display 
Postscript™ instructions as regular characters and control 
characters as hexadecimal ASCII codes. 


Create File and Directory Catalogs 

QUED/M can copy the file and directory listings (shown in its 
special File dialog) and create an organized, alphabetized catalog 
listing of all your files. 


Keep an Appointment Book 
You Can maintain and easily access a general notebook with 
appointments, names, addresses, and phone numbers. Each day 
you can copy all of your appointments for the day into a new 
window using the special Macros menu item called 
Appointments”. You can prepare daily instructions for your 
secretary, which he or she can extract and print by choosing a 
single customized Macros menu item. 


Maintain a Text Data Base 
Using your own format for data files, QUED/M makes data 
extraction easy. You are not restricted in what your fields are to 
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be, and you do not have to specify how many fields each record 
is to have. Suppose you have several files with names and 
addresses of business contacts, with brief notes about each. A 
single menu selection will extract a list of names and addresses 
by city, zip code, or by key words. Existing text files can be 
added to your data base without any special considerations. 


Maintain a Bibliography 

Keep a bibliography of technical references, which includes 
short abstracts of the topics. This is just one of the possible 
specialized data bases you can maintain with QUED/M. 


Create Mailing Labels ' 
QUED/M macros can reformat text files to make them 
appropriate for mailing label programs or data base programs. 


Solve Problems as They Arise 

As you discover the power of QUED/M, you will find many 
other applications for it. The flexibility offered by the macro and 
Regular Expression facilities allow QUED/M to solve problems 
that would otherwise require specialized programs. One 
application that was suggested by a customer was the use of 
QUED/M to create and maintain a specialized recipe book. A 
macro can be created to locate recipes that use ingredients that 
you currently have an excess of or find recipes that meet specific 
dietary restrictions. 


2.1 The QUED/M™ Disk 
The QUED/M™ Disk contains the following files: 


¢ QUED/M x.xx 
x.xx being version number which is part of file name 
¢ QUED/M Macros File 
¢ Macro Listings File 
¢ QUED/M Help Files 


It can also contain a "Read Me" file, which contains last minute 
information which was too late to be included in this manual. 
The Read Me file, if present, and the Macro Listings files are 
QUED/M documents that can be read using QUED/M. 


The Macro Listings file, contains listings of all the macros 
provided for your use. The executable macros themselves are 
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located in the QUED/M Macros file, which is a QUED/M data 
file, not a document file. If you would like to have the macros 
automatically loaded at boot time, you will have to rename that 
file (the “QUED/M Macros File”) to “QUED/M Macros”. Do this 
only after you have read the section on programming macros 
(Section 9) in order to avoid confusing your macro names with 
the ones supplied. 


Your Macintosh cannot be booted using the original QUED/M 
disk because it lacks the System and Finder files. Before using 
QUED/M, you must perform the following procedure: 


¢ Initialize a new disk. : 

¢ Copy the current System, Finder, and ImageWriter 
files to the initialized disk. . 

¢ Copy all the QUED/M files to this new disk. 


Alternatively, you can copy QUED/M and its files to a hard disk, 
if you have one connected to your Macintosh, and use it from 
there. You should never run QUED/M from the supplied disk, 
keep it as a backup instead. 


IMPORTANT NOTICE: Do not change in any way the 
original QUEDIM program on the original disk. The very 
process of using the program from the original disk may change 
it. We will be offering (via public computer networks) free bug 
fixes to our registered users via our PUP™ (Paragon Updating 
Procedure) program. The updating process, however, will 
require an original, unmodified QUED/M program disk. Use the 
original for backup only, copying it when necessary to your 
“work” disk. 


QUED/M is completely memory resident. The contents of all 
files opened simultaneously must fit into memory. As many files 
(windows) can be opened as memory space allows. Similarly, 
the maximum size of a file is limited only by the available 
memory. Typically, if you are using a Macintosh Plus with 1 
Megabyte of memory, you can edit documents of up to about 
300K. Larger documents can be read in and edited, but there are 
some memory-intensive program operations that may display an 
“out of memory” error message. (Please note that when 
QUED/M is short of memory it also blackens the inactive 
windows.) Large documents can often be split into smaller ones 
to facilitate and speed-up editing. 
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2.2 Running QUED/M under MultiFinder 


Apple’s MultiFinder allows several programs to be run 
simultaneously. QUED/M is completely compatible with 
MultiFinder. If you are planning to run QUED/M under 
MultiFinder, there are several points to be aware of. 


¢ It is difficult to use MultiFinder on systems with one 
Megabyte or less of memory. 

¢ You must tell MultiFinder how much memory 
QUED/M will use. This is done by clicking on the 
QUED/M icon in MultiFinder, choosing Get Info 
from the File menu, and changing the number in the 
Application Memory Size rectangle. Ideally, this 
number should be set to 600 or larger, to allow for 
editing large files. If you are using a 1-Megabyte 
Macintosh and you wish to run another program 
simultaneously, you may have to set the memory size 
for QUED/M to 400 or smaller. If QUED/M cannot 
open a file under MultiFinder, it probably means you 
have to increase the memory assigned to it. 

¢ At the time of this printing, QUED/M provides no 
MultiFinder-specific macros. The automatic macro 
SWITCHIN will be executed whenever QUED/M is 
reactivated under MultiFinder. However the 
corresponding macro SWITCHOUT does not get 
executed when QUED/M is deactivated and another 
program is run. 


Conserving memory becomes an important consideration when 
attempting to run several programs simultaneously under 
MultiFinder. Here are some tips for conserving memory in 
QUED/M. | 
* Edit small files. If necessary, break large text files into 
smaller files for editing. 
¢ Keep a small undo list. The number of actions 
QUED/M will remember to undo can be set in the 
Options dialog, which is available via the File menu. 
¢ Close any files you are not currently editing. 


This information should allow you to set a smaller Application 
Memory Size in MultiFinder for QUED/M, which will leave 
more memory available for running other programs. 
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3 GENERAL TEXT EDITING 
3.1 The Menus 


Stack Windo 
Tile Windows 
Resize Windo}-- 
Hide Tent 


Transfer xT 
Edit Transfer 


Change 
Jump 
Set Marker 


Balance Parens 
Recount Parens 
Set Parens... 

¥ Paren Checking 
Zap Gremlins 

~ brem/in Rlert 
Enter ASCII... 


Lowcase 
Change Case 
Capitalize 

; Sort Lines 
Campare 


Break Lines 
Change Tahs->$p 
{_ Change spaces-> 


“Clipboard 0 
Clipboard 1 
Clipboard 2 
Clipboard 3 





Figure 1 


All the menus (except Font) are shown open in Figure 1. You 
can refer to this as you read through the mienu and command 
listings in Section 10. In QUED/M, only one menu can be open 
at one time, of course. 


3.2 Toggle Options 


There are two types of menu items. One type is acted on upon 
selection. For example, selecting “Find...” from the Search 
menu will immediately display the dialog into which you type a 
word to search for. The second type of menu item is called a 
toggle. It is essentially an on/off switch for a QUED/M option. 
Simply selecting the menu item alternately turns the option off 
and on. When a toggle is turned on, a check mark appears to its 
left on the menu. 
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The item “Global Search” in the Search menu is such a toggle. 
When it is turned on, all searches and replaces are carried out in 
all the files that are open at that time. When a toggle menu item is 
turned off, the check mark disappears. Unlike most other 
Macintosh applications, QUED/M will allow you to toggle menu 
items while the Open... and Save As... dialogs are being 
displayed. 


All toggle menu items are displayed in italics. Menu items that 
call up a dialog box are followed by an ellipsis (...). 


3.3 Opening Files 


When opening files you get the special Open dialog shown in 
Figure 2a. You can switch between the two forms of dialog by 
clicking in the zoom box of the dialog window, or by double- 
clicking the top title bar of the dialog. The form of the Open 
dialog shown in Figure 2a does not disappear after opening your 
files; rather, it remains behind your file windows. The dialog 
shown in Figure 2b, like the traditional Macintosh Open dialog, 
disappears automatically after files are opened. 


QUED/M’s Open dialog has many capabilities that other 
Macintosh applications lack. Here are some examples: 


* Dragging through contiguous file names (or shift- 
clicking) selects a set of files, all of which can then be 
opened simultaneously. 

* Select “Copy” from the Edit menu to copy selected file 
names from the dialog to the clipboard for pasting into 
a document later. 

* QUED/M allows you to leave this dialog open. It will 
not interfere with editing another window. You can 
bring it to the front by clicking in it as usual. 

* Change the font or text size used to display the file list 
to any of those on the Format menu. 

* Use the general “Find...” dialog (available in the 
Search menu, or by typing Command-F) to find a file 
name in the list. 

¢ Turn on line numbers (via the Format menu) to see 
how many files you have in the current folder. 

* Select a different disk drive from a menu. The drive 
menu appears when you click down on the current 
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drive name box to the right of, or below, the file list. 
See Figure 2a. 


=z 
[a QUED/M 2.0 Folder } 
EB) Beta Testers List KK} 


DB) Features list QUED MM. dict i= 
P) nAWord Features 
© Mamual Folder 

I 


© QUED/M 2.0 Folder 


&) Beta Testers List KY 
&) Features list QUED/M dict 
FE) mAword Features 


es 






B QUEDAM Reviewers 










iY) 


Add to search A 
Remove from search xR 
~ TEXT only %\ 
New ae 





HB) Beta Testers List 
) Features list QUED/M.dict 
2) NAWord Features 





To open a new file, choose “New...” from the File menu. A file 


dialog will appear to allow you to choose a name and directory 
for the new file. ° 
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Your ability to open files is limited only by the amount of 
available memory. The memory indicator (the number which 
serves as the title for the Special menu, between the Transfer and 
Macros menus) will help you gauge current usage. Be aware that 
QUED/M does need free memory beyond that used to hold the 
current file or files in memory. The amount of available memory 
required depends upon the size of the files as well as upon other 
things (such as how many lines the files have). Some QUED/M 
operations on a file require the Mac to have more than twice as 
much free memory available as the file occupies on disk. 


File Names 
If you find two files with identical names in the Open dialog and 
one is followed by a black dot, then that particular file has a 
return character in its name. The return character can only be 
entered by accidentally pasting it into the Save As dialog. To 
remove the return character quit from QUED/M and retype the 
file name after selecting it in the Finder. 


Opening Many Files Simultaneously 


From the Finder 
When you wish to open several files at once from the Finder 
(not from QUED/M), select the QUED/M application icon and 
the files to be opened (by clicking, Shift-clicking, or using the 
Finder’s selection rectangle), and then choose Open from the 
File menu. ~ 


When QUED/M is opened from the Finder with more than 16 
files, it asks “Really open 17 files?” This feature is provided in 
case you have made a mistake, since opening a very large 
number of files from a floppy disk can take some time. 
QUED/M will then open those files in a tiled, side by side, 
format. Fewer than 16 files are opened in a stacked format. 


In Tiled Format 
When opening a file from within QUED/M keep the Option key 
down while clicking the “Open” button if you want it to open in 
the tiled format. 


Aborting Multiple Open 
If you change your mind about opening multiple files after 
clicking “Open”, you can still abort the opening process with the 
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general “Cancel” key sequence, that is press the Command and 
period keys simultaneously until a dialog appears. 


3.4 Stacking and Tiling Windows 


Opening files in the stacked format brings them up slightly 
offset, as shown in Figure 3. To bring a file up to the front for 
reading, click inside its window. 


i ________Herabisk:cruterproc.c_ 


7 eae a HardDisk:checkparen.c 















: *include “edit.h” 
| “include “ctype.h” 
*define SHOWDIALOG 


i “define BEEP 2 
*define NOTHING 3 











Figure 3 


Select “Tile Windows” in the Format menu to arrange windows 
on the screen side by side, as in Figure 4. Sixteen files are 
shown opened. To be able to read one of these windows you 
would need to make it fill the screen. This can be done by 
double- clicking its title bar. (In QUED/M, double-clicking in a 
window’s title bar has the same effect as clicking in the zoom 
box on the right side of the title bar.) When you have finished 
reading and editing the file you can double-click its title bar (or 
click its zoom box) to make it small again. You can then repeat 
this zoom in - edit - zoom out process for the next file. 
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Figure 4 


When the Sync Scrolling option is turned on, double-clicking 
the title bar (or clicking the zoom box) causes the two top files 
(that is, the two most recently worked in) to appear, arranged in 
side-by-side windows on the screen, ready for synchronized 
scrolling. Side-by-side windows can also be obtained by 
holding down the Option key while double-clicking the title bar 
or clicking the zoom box. 


- 3.5 The Active Window 


The active, or top, window is the window you are currently 
working in. When clicking from one window into another, the 
active window is the one in which you clicked most recently. 
The flashing I-beam shows your position. If you have several 
windows open, an I-beam may be visible in each, but will only 
be flashing in the active window. You can also identify the 
currently active window by its striped title bar. 


Most commands in QUED/M affect only the active window, 
(except for a Global Search, Multifile Search, or Change and 
certain actions performed with the Command key held down), 
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(see Section 12). Some commands, however, will affect all open 
windows if the Option key is held down while they are selected. 
These are identified in the menu item descriptions in Section 11. 


3.6 Split Windows 


Each window can be split horizontally and vertically into 
independently scrollable “panes” by dragging small black 
regions in the scroll bars to the desired split points. Figure 5 
illustrates these and other window controls. 








®include 
Sinclude 
Sdefine SHONDIALOG 


®define BEEP 2 
Sdefine NOTHING 3 










‘] region to change 
ayy herizontel split 
sit ecreen. 

Hold down mouse 


Drag this bleck region to change vertical screen split. 
Figure 5 
3.7 Rear Window Controls 


The standard window controls (resizing, selecting, I-beam 
positioning, scrolling, etc.) work in inactive, or “rear” windows 
when the command key is held down. This is particularly useful 
when a Find or Change dialog is in front, and you want to move 
the I-beam in the editing window to a different starting point 
while leaving the dialog window active. 
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4 MULTIFILE SEARCH 


The Multifile Search feature allows you to search through and 
perform replacements in unopened files. The files QUED/M will 
search through are identified by a “search list.” 


Adding to the Search List 

¢ Make the Open file dialog the top window. (Choose 
Open from the File menu). 

¢ Select a file, or a contiguous group of files, in the 
“Open dialog” file list by clicking or dragging. 

¢ Add the selection to the search list by choosing “Add 
to Search” from the "Other" submenu. The Other 
submenu is at the bottom of the Open dialog, as in 
Figure 2a. 


This will mark the selected file or files with an “eye” icon. To 
add more files to the search list, repeat the above steps. The files 
can be in different folders and on different disks. 


Any files in the search list that have been searched through (with 
a Find or Change) are automatically removed from this list. This 
prevents them from being searched again. 


If you want to keep a copy of the files on your search list, 
execute the “Save Search List” macro supplied in the macro file, 
prior to doing any additional searches . (The use of macros is 
described in Section 8.) This macro copies the full path names of 
the files in the search list to the current clipboard. After 
executing the Save Search List macro, you can see (and save) 
the names of the files in the search list by opening and naming a 
new file, then doing a Paste. 


Next time you want to add the same files to your search list, run 
the macro “Restore Search List”. It assumes that your file 
window which contains the full search list, is the top window. 
Make sure there are no blank lines in this search list file or you 
will get an error message. 


A Find or Change executed now will search through the files on 
the search list, as well as through the top open file (if any). If 
you do not want to search through the unopened files, but still 
want to leave them in the search list, toggle off the “Multifile 
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Search” in the Search menu. To search through them again, 
toggle this item back on. 


Removing Files from the Search List 
To remove an individual file from the search list, select its name 
in the file dialog, then choose “Remove from Search” from the 
Other submenu. To clear the search list press and hold the 
Option key while selecting “Remove from Search”. 


Important Note- When searching through unopened files it 
is important to remember that the unopened files have not had 
their line starts calculated. You can search for something at the 
beginning of an explicit line (one which was preceded by the 
return character), since explicit line breaks are marked by the 
return character (ASCII hex OD, decimal 013). Searching for 
something at the beginning of a wrapped line in an unopened file 
is impossible. 


When searching through unopened files, QUED/M loads them 
into memory one at a time, then performs the search or replace. 
Each file must therefore, fit into memory. 
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5 MARKERS 


QUED/M allows you to set invisible “markers” in a text file. 
Although these markers do not appear on screen, QUED/M 
remembers where you placed them and allows you to locate 
them instantly from anywhere in the file. 


Set Marker 

To place a marker in a file, choose Set Marker in the Search 
menu. Then type any name or number for the marker, and click 
the Set button or press Return key. QUED/M places a marker at 
the location of the I-beam, or before the first character of any 
selected text. If you select text and then choose the Set Marker 
item, the default marker name will be the first word of the 
selected text. 


Once set, markers appear at the end of the Search menu. All 
markers in windows other than the active window are shown 
preceded by the file name. 


Reusing Marker Names 
If you reuse a name for a second marker in a file, it will replace 
the first marker with that name. The same name can be used for 
separate markers in different files. - 


The NIL Marker 

If you choose the Set Marker item from the Search menu with no 
text selected and then click the “Set” button without entering a 
marker name, QUED/M will set the special marker “NIL” at the 
current I-beam position. When you jump to this marker from 
some other position in the file, QUED/M exchanges the marker 
position with the previous position of the I-beam. Thus, with the 
NIL marker, you can repeatedly jump between two positions in 
the file. There can only be one such special marker per file. You 
can also define another marker called “NIL” by typing its name 
into the Set Marker dialog, However this is not advised because 
sometimes QUED/M could jump to the wrong “NIL” marker. 


Jump 
To jump to a marker, select it from the Search menu, or select 
Jump from the Search menu, type the marker name, and click 
the Jump button. The latter method requires that the marker 
name not be a number because QUED/M will interpret it as a line 
number. 
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Deleting Markers 
To remove a marker from a file, press and hold the Option key 
and select thé marker to be deleted from the Search menu. 
Alternatively, select, Set Marker... from the Search menu, type 
the marker’s name into the dialog, and click the delete button. 


Use this second method if you have more than 11 markers and 
you are using the old MFS operating system and Macintosh 
ROMs. (Only 11 markers are shown on the menu in that case.) 
A Macintosh with newer (128K or larger) ROMs will allow you 
to scroll through a list of up to 50 markers. 
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6 TRANSFERRING TO ANOTHER APPLICATION 


Transfer 
The Transfer menu (Figure 1) can be used to leave QUED/M and 
run another application directly. When Transfer is selected a file 
dialog is displayed showing only application files. From this 
dialog you can transfer to an application by double-clicking its 
name or by selecting it and clicking the transfer button. 


If you have to transfer often between QUED/M and another 
program, you can save time by adding the other program’s name 
to the Transfer menu list. To do this select Edit Transfer... from 
the Transfer menu, and a window like the one in Figure 8 will 
open showing the list of programs in the Transfer menu. 


This Transfer menu window is similar to any other edit window. 
You can make it fill the screen by double-clicking the title bar. 
You should type into this transfer list the names of the programs 
which you want to run after leaving QUED/M. Type one 
program name per line. 


To add the name of a program which is not in the current folder 
you must precede it with the full path to the file (that is, the 
volume or disk name and a list of the folders in which the 
application program is located, each separated by a colon). You 
can add several such program names (with paths if necessary), 
each on a separate line. When you have finished editing, click 
the close box. This will make the added applications available in 
the Transfer menu. Remember to Save Defaults (from the File 
menu) if you want to have the same transfer menu list available 
the next time you use QUED/M. You can now transfer to any of 
the added programs by selecting its name from this list. 


Transfer List : 
The following is a quick and accurate method of making a 
transfer list. One of the Macros supplied with QUED/M is called 
“Save Search List”. It copies to the current clipboard the full 
path to each file on the search list. All you have to do is the 
following: 


¢ Bring up the file dialog by choosing Open... from the 
File menu. 

¢ Open the Other submenu (to the right of the Drive 
button) and toggle the TEXT only item so that it is not 
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checked. This allows you to select non-text files, 
specifically applications. 

Select the application files you want to have on your 
transfer list and add them to the search list. (Select 
Add to Search from the Other menu.) 

Execute the Save Search List macro by choosing it 
from the Macro menu. If you cannot see it on the 
Macro menu, you will have to load the macro file 
first. Read Section 8, Using Macros, if you have 
difficulty doing this. 

Choose Edit Transfer from the Transfer menu. 

Delete from the Transfer menu window the lines with 
file names you no longer want to appear on the 
Transfer menu. 

Place the I-beam at the beginning of the next line in 
the Transfer menu window and choose Paste, from 
the Edit menu, which will paste the file list into the 
window. 

Close the Transfer window. 

Verify that the Transfer menu has the correct 
application names in it. 

Choose Save Defaults from the File menu if you want 
to preserve this version of the transfer list. 


Edit 


Transfer 
Edit Transfer 


QUED 1.5 

Exec 

Link 

RMaker 
Resource Editor 


Link 
RMaker 
Resource Editor 


hh 
HardDisk:library 
Batch he 
(- 
myprog /5 


HardDisk:llbrary 
Batch % 
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Adding Command Key Equivalents 
If you want a Command key equivalent for any of the programs 
on the transfer list, follow its name with a space, a slash (/), and 
then the key equivalent. In the example in Figure 6, the item 


“myprog” has the key equivalent 965. Notice you do not have to 


type in the 9 symbol into the transfer list window, it will appear 
automatically in the menu. 


If you want to have a dotted line appear across the full width of 
the transfer menu type (- (that is, parenthesis minus) at the 
beginning of a blank line. (See Figure 6.) If you want an item to 
be disabled on the Transfer menu begin it with a left parenthesis. 
Each such item will appear dimmed on the menu and you will 
not be able to choose it. 


Removing Key Equivalents 
To remove an existing key equivalent from the transfer menu 
choose Edit Transfer from the Transfer menu, remove the slash 
(/) and the symbol following it. If it is the last item on the list, 
follow it with a Return. 


Transfer a Document File 
The next application (the one transferred to) can automatically 
open a document. To have the file in the active QUED/M 
window opened by the application transferred to, follow the 
name of the application on the Transfer menu with <tab>% 
(that is, after the file name, type a tab character and then a 
percent sign.) 


If you were editing a document in QUED/M and you chose the 
item 
Main Volume:NISUS <tab>% 


from the Transfer menu list, you would end up in the same 
document but in the word processor NISUS. 


To have all of the open files also open when you transfer to the 
next application, follow the application’s name on the Transfer 
menu with 

<tab>%%. 
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You can also transfer any file, other than the one which is open, 
to the next application by typing its name following the <tab>. 
For example, choosing the item 


MainVolume: Nisus<tab>Notes<tab>%/B 


from the transfer list will transfer you from QUED/M to Nisus 
on the disk MainVolume. This will then open the file called 
Notes, and the file which was the active window in QUED/M at 
the time of transfer. In this case, since Command-B (/B) is the 


key equivalent, typing 98B will have the same effect. 


Remember also that if you want to preserve the changes you 
have made to the transfer list, you must choose Save Defaults 
from the File menu. 


Bad File Names 

Be aware that two characters, the exclamation point (!) and the 
slash (/), must not be used in a file, folder, or disk name if you 
want to transfer to them using this custom menu. The slash (/) is 
used to indicate a Command key equivalent. The exclamation 
mark is used to show a check mark, or indeed any character, in 
front of a name on the menu. You should also avoid using the 
space (or any other invisible character, such as a tab) at the end 
or beginning of a file or disk name since it is not easily 
recognizable. 


Important Note - Because of these restrictions, if you want to 
add QUEDIM to the Transfer menu, you should change its name 
to QUED-M or QUEDM. 
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7 METACHARACTERS (Regular Expressions) 


(If all you want to do is find and change expressions literally 
then you do not need to read this part of the manual. Just 
remember to have the Regular Expression check box (in the 
Find/Change dialog) unchecked at all times.) 


Warning - The Regular Expression and Metacharacter 
facility is a very powerful set of features. As such it 
can also be dangerous to your data unless you 
understand what you are doing. 


If you are familiar with the UNIX™ Regular 
Expression set, you will find this relatively easy. 
Otherwise, allow yourself plenty of time to become 
familiarized. Be sure to back up all your work in case 
any experiment you attempt fails! Remember that any 
executed command that changes text, including any 
macro, can be undone. 


7.1 Introduction to Metacharacters. 


Metacharacters are used when you want to find or replace text 
chat you do not know literally (or which can have several 
lifferent literal realizations) but whose structure you can define. 
We first describe how the Find and Change work in QUED/M, 
ind then provide some examples and details of the powerful 
netacharacter features. 


Find and Change 
When you do a Find (using the Find item in the Search menu) 
he found expression (or Target expression) is selected. If you 
ise the Change item, the found (selected) expression is replaced 
vith the Destination expression, with whatever you typed into 
he Change To dialog. 


Examples of Metacharacter Uses _ 
Jere are a few examples of things you can find using 
netacharacters: 


¢ A sequence of one or more digits 

¢ Any telephone number written in any number of 
different ways 

¢ An address which includes a zip code 
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Any uppercase character 

Any lowercase character 

The beginning of a line preceded by a Return 

The beginning of a line, which is automatically 
wrapped (that is not preceded by a Return 

¢ The beginning of a word 


Metacharacters: Selecting and Nonselecting 
The metacharacters in QUED/M can be divided into two 
categories: those which, when found, cause text to be selected, 
and those that do not select text. Items 1 through 6, listed in the 
examples above, are text-selecting, whereas the last two items 
are nonselecting. When a nonselecting expression is found, the 
I-beam jumps to the represented position, but no text is selected. 
All except two of the nonselecting metacharacters represent 
positions rather than actual characters. The two exceptions are 
the “previous character” and the “next character”. Thes. can be 
used to specify the nature of the character preceding or following 
a position (such as the beginning of line or word) without 
selecting it. When a nonselecting expression is replaced with a 
destination expression the action amounts to an insertior (of the 
destination expression) at the position of the target. Non: 2lecting 
expressions cannot be used as any part of the destinatioz:. 


Target Expression 
The most common application of metacharacters is in the Target 
Expression of a Find or Replace. Very few metacharacters are 
usable inside the Destination Expression. 


Destination Expression 

A simple rule applies to determine whether an expression can be 
used as the Destination Expression of a change. If the 
expression represents a unique character or expression (without 
any ambiguity) then it can be used as part of the destination set. 
An ampersand (&) may be used as all or part of the Destination 
Expression and means “the last expression selected”, which is 
usually the expression found. Expressions such as those in 
items 1-9 above cannot be used as Destination Expressions 
because they are too general, and QUED/M will not know what 
they represent! 
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7.2 Using Metacharacters 


Metacharacters are characters and sequences of characters that 
have special meanings when used in the Find and Change 
dialogs. These sections explain some uses of metacharacters. 


Introduction 
QUED/M has the ability to make sophisticated text searches. For 
example, it can search for a single word occurring at the 
beginning or end of a line, or one word out of a set of several 
words, or a repeated phrase. It can also make automatic changes 
such as swapping words or letters. 


Usually, the Find and Change dialogs are used without their 
“Regular Expression” boxes checked. This permits literal 
searches and changes: characters, words, or phrases typed in are 
used just as they appear in the dialog. (Note that QUED/M 
allows you to enter the return and tab characters into the dialogs 
by pressing Shift-Return and Shift-Tab. 


To allow the designation of such things as “the beginning of a 
word” or “any alphabetic character” we use ordinary characters 
but give them special meanings in certain contexts. Expressions 
using these special or “meta” characters are called “Regular 
Expressions”. When searching for a Regular Expression, the 
“Regular Expression” box must be checked in the Find or 
Change dialog. 


Example 1: Find Line Beginning 
means “the beginning of a line” 


$ means “the end of a line ”. 


The dialog in Figure 7 would find the next word “Beware” only 
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Figure 7 


where it occurs at the beginning of a line. Similarly, searching 
for 


congregate$ 


will be matched to the word “congregate” if it occurs at the end 
of a line in the file. (Note this does not include an automatically 
wrapped end of line). 


There is often an ambiguity in using metacharacters. What if you 
want to search for “congregate$” literally, rather than for 
“congregate” at the end of a line? One way in the example would — 
be to turn off the Regular Expression option in the Find dialog. 
Another way is to tell QUED/M to “turn off” the special meaning 
of a particular character and to interpret it literally. This is done 
by preceding the character with a backslash. So, to find 
“congregate$” anywhere in a file, you could leave the Regular 
Expression option on and search for “congregate\$”. To find the 
eight characters “:\Beware”, type in 


\: \*Beware 


To use the backslash literally inside a Regular Expression use 
two backslashes. To search for “hello\goodbye”, use the 
Regular Expression “hello\goodbye”. (The one exception to this 
use of the backslash concerns the writing of Macros. Inside a 
macro the double quotes “"” have a special meaning. To use 
them literally you do not use the backslash, instead you double 
up the quotes.) 
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Example 2: The Wild Character 

In a Regular Expression, the period matches any character 
except the return character. Thus the expression “suppose.” 
(suppose period) would be matched by the word “suppose” 
followed by any character except return. An attempt to find 
“suppose.” might stop on “supposes”, “supposed”, “suppose ” 
(with a space at the end), or even on “suppose.” itself. To use a 
period literally inside a Regular Expression it must be preceded 
by the backslash: “suppose\” would match to the word followed 
by a period, which usually occurs at the end of a sentence. 


Here is an expanded explanation of Regular Expression use. 


The Backslash Modifier 

The backslash character \ is used to change the meaning of the 
character following it. If you want to use a colon literally in your 
Regular Expression search string, you can precede it with a 
backslash to “turn off” its special meaning. Similarly, some 
characters which have no special meaning in Regular 
Expressions become endowed with special significance when 
preceded by a backslash. For example, to logically group parts 
of Regular Expressions, we use parentheses preceded by 
backslashes, \( and \), as in Example 4, Swapping Words. 


The Colon 
If the Regular Expression box is checked in the Find/Change 
dialog, the colon, when intended literally, must always be 
preceded by the backslash. Like the backslash, the colon acts as 
a modifier of whatever character follows. When the colon 
follows a backslash then it is to be interpreted literally. 


Example 3: Finding Digits 
The Regular Expression :d stands for “any digit”. So, to locate a 
three digit number, check the Regular Expression box and 
search for :d:d:d. To find a standard 7-digit phone number, the 
appropriate Regular Expression is 


td:d:d\-:d:id:d:d. 
Notice that we want to find a literal dash in the phone number; to 


avoid the special meaning normally given to the - character, we 
put a backslash before it in the expression. 
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Parentheses 

In Regular Expressions parentheses are normally treated 
literally. When preceded with the backslash they take on a 
special meaning. Using the expression \((RE\) (where RE stands 
for any Regular Expression as the search expression) the search 
proceeds as if the “\(” and ‘\)” were not present. But the 
expression matched by RE is remembered so that in the 
replacement expression (the “Change to” expression) we can 
refer to the parenthesized portion of the search expression. A 
“\1” in the “Change to” box of the Change dialog will be 
replaced by whatever matched the first parenthesized expression. 
Up to nine parenthesized segments of a search String can be 
referred to in this way, using the notation \l, \2, ge 


Example 4: Swapping Words 
One use of this subexpression parenthesizing is in swapping 
expressions or words. To replace “human body” with “body 
human”, check Regular Expression in the Change dialog and use 
these Regular Expressions, 


Find What: \(human\) \ (body\) 
Change To: \2 \1 


Repeats 
The plus, minus, and asterisk symbols (+ - *) are used in 
Regular Expressions to signal a possible repeating of the 
Previous character or bracketed expression. 


' One or More 

+ A plus sign following any character (or bracketed set of 
characters) means the expression should match one or more 
occurrences of that character. “a+” would match any occurrence 
of one or more a’s, matching as many as are found together. 
When QUED/M is searching for “a+” and finds a sequence like 
“aaaa” it will select all four characters, rather than just the first 
one. 


Zero or More 
e The asterisk meta character following another character 
means zero or more occurrences of that character. Therefore the 
only difference between * and + is that * will match to no 
occurrences whereas + must find at least one. For example, the 
expression “al*e” would find the two letters “ae” as well as the 
words “ale”, “alle”, “allle”, and so forth. “‘al+e” would match to 
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all of the same expressions as “al*e” except for the case of zero 
occurrences of the l, “ae”, which “al+e” would skip. 


Zero or One 
- A minus sign following a character means zero or one 
occurrence of that character. To continue the above example, “al- 
e” would match only to the expressions “ae” and “ale”. Be aware 
that the minus does not signify zero or one occurrence inside 
brackets (as in [a-c]), where it has a different meaning. 


Beginning of Word 
\< signifies the start of a word. Searching for \< will move 
the insertion point to immediately before the next word. The 
Regular Expression \<m will find any word beginning with the 
letter m, and select the m. The Regular Expression \<:? will find 
the beginning of the next word (no matter what it is). 


End of Word 
> Searching for the Regular Expression \> will move the 
insertion point to the end of the word. The expression s\> will 
match to any word ending in the letter s, selecting just the final 
s. Similarly, using the Regular Expression :”\> will find the end 
of the next word and select its last character. 


The “OR” Metacharacter 
You can search for one or more expressions using the vertical 
line | to represent “or”. The Regular Expression: 


alpha|beta 


would only match to the word alpha or the word beta and to no 
others. The expression: 


thomas|ellis|john| judy 


typed into the find dialog with the Regular Expression box 
checked would find any one of the names: thomas, ellis, john, 
or judy. 


If you check the Ignore Case item in the Search menu, the 
upper-case/lowercase distinctions are ignored when determining 
matches. If you only want whole words found, check the 
“Whole Word” box in the Find or Search dialog. Whole word 
searches prevent “John” from being found within “Johnny”. 
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Note however that if the whole word box is checked the target 
expression must not contain any meta-symbols which would not 
be a part of a word, otherwise all searches will fail! 


For example, searching for the word “Allen ” followed by a 
space character, with the “Whole word” option turned on, would 
not find anything since the space character cannot be part of a 
word. 


Notice that normally the or (I) refers to everything to its left 
(back to the previous “or’’) “ored” with everything to its right 
(up to the next “or”). This means that only groups of characters 
(generally words) can be “ored” this way. If you want to have 
an “or” between two parts of a word only, you have to use 
parentheses preceded by backslashes. The next example 
illustrates this point. 


Example 5: Finding with OR 
The expression: 


alph\ (a| abet \) 


would be matched by either the word alpha or the word 
alphabet. 


Importance of Order 
Notice a subtlety in Example 5. If the Whole Word option is not 
checked, a search of: 


alph\ (a| abet \) 


will never find the word alphabet. The reason is that QUED/M 
first looks for the first expression, “alpha”, and if no match 
occurs, will then try to match the next expression, “alphabet”. 
Since QUED/M will always find the word “alpha” inside of the 
word “alphabet”, the latter will never be found. Reversing the 
order of the two “ored” expressions alph\(abetla\), the Search 
would always find both words, whether or not the Whole Word 
option is checked. 


7.3 Metacharacter Listings 


The following is a listing of all the metacharacters, and a detailed 
explanation of their use. 
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Line Referenced (Nonselecting) 
The end of a line. 


Beginning of any line, including automatically 
wrapped lines. 


The beginning of a line preceded by a return. 
Inside brackets it means “not”. Used to specify 
characters not included in the specified set. For 
example, the expression [4A-Z] means any 
character not in the set A through Z. 


Word Referenced (Nonselecting) 
Beginning of a word . This means “the previous 
character is not alphabetic, numeric or an 
underline, ‘and that the following character is an 
alphabetic, numeric or an underline”, Expressing 
this in terms of other metacharacters, it is 
equivalent to :<[*A-Za-z0-9_]:>[A-Za-z0-9_] 


End of a word . 


“Characters” (Nonselecting) 
Previous character. Thus the expression :4:<[A\r] 
means the start of any wrapped line. Note that 
“previous” means the character preceding the 
symbol :<. For example, the expression :u:<[AA- 
F] means any uppercase character (:u) not in the 
set A through F, 


Next character. Thus :>[A-Z] matches only if the 
next character is uppercase alphabetic. This will 
place the I-beam to the left of any uppercase 
character without selecting anything. Note that 
“next” means the character following the symbol 
:>. For example, the expression a:>[4.] means “a” 
not followed by a period. 


Text Related. (Nonselecting) 
End of text. 


Start of text. 
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~ 


\0 
\b 
\f 
\n 
\r 

\s 
\T 
\t 


ee 
ems 
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Special Characters (Selecting) 

(“Colon space”) any control character (dec ASCII 
0 through 31). 

Blank (space or a tab). 

Followed by any character besides 0-9, C, T, b, f, 
Nn, T, S,t,<, >, (, ), matches that character literally. 
Thus, \[ matches [. This is needed when you wish 
to use literally one of the metacharacter symbols, 
which, without the backslash, would have a 
special meaning. 

(Zero) The null character, (decimal 0). 

Backspace character (decimal ASCII 8). 

Form feed character (decimal ASCII 12). 

New line or line feed , (decimal ASCII 10). 
Return character (decimal ASCII 13). 

Space character (decimal ASCII 32). 

Zero or more spaces followed by a tab character. 
Tab character (decimal ASCII 9). 


Character Classes (Selecting) 
(Period) any character except return. 


Any “Gremlin” (that is any option or shift-option 
character). 


(Or :.) any character at all, including return. 
Gremlin, tab or space, but not the return character. 


Alphabetic character or diacritical character (such 
ast...) 


Alphabetic character or underline. A-Z, a-z and _ 


:# or :d 


:x or :h 
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Any lowercase character. 


Alphanumeric or underscore, such as A-Z a-z 0-9 
or 


Alphanumeric or diacritical characters. 
Uppercase character. 


Digits (Selecting) 
Any digit. 


Octal digit. 
Hexadecimal digit. 


Character Sets (Selecting) 

Stands for one character in a set. (The ellipsis ... 
has to be replaced by the set definition.) The set 
may be defined as a range, an enumerated set, or a 
combination of both. The return character may not 
be included in the set. For example, [a-z] means 
any character in the range a to z. The set is 
specified by enumerating the characters inside the 
brackets. Each of the specified characters must be 
uniquely defined. For example, “:a” (meaning any 
alphabetic character) cannot be used. It would be 
interpreted literally, as “match either a colon or the 
letter a." 


Stands for one character not in a set. For example, 
[‘a-z] means any character not in the (ASCII) 
range a to Z. 


Similar to [ ... ], but return character may be 
included in the set. For example, [*A-Za-z] 
matches any nonalphabetic character except 
Return. :[4A-Za-z] matches ANY non-alphabetic 
character, even if it is a return. In a similar way, 
:[A-Za-z\r] matches any alphabetic character 
including the return. 
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Repeat Expressions 
All of these refer to the previous character or bracketed 
expression. 


* Zero or more occurrences of the preceding 
expression. 

+ One or more occurrences of the preceding 
expression. 


- Zero or one occurrence of the preceding 
expression. 


+, 1+, :* . Same as -,+,*, but finds the shortest strings, 
rather than the longest. 


Note that when searching in reverse, the shortest 
string is always the one found, no matter which 
repeat expression is used. 


Logical Constructs 
a Used to parenthesize Regular Expressions. Any 
expression between these is treated as a single 
character for the purpose of Repeat Expression 
symbols. 


| “Or” This takes a Regular Expression on each 
side. It connects everything on its left with 
everything on its right. 


& Stands for the current (or if none, then the last) 
expression selected. Can be used inside double 
quotes in any destination expression provided the 
Regular Expression is turned on. Must be used 
inside single quotes if the Regular Expression is 
not turned on, or inside commands that have no 
Regular Expression toggle. 


Vi... The first (...ninth) parenthesized expression 
selected. This is used to reference the bracketed 
expressions. Can be used in both the Target and 
Destination expressions. For example, the target 
expression \(“.+\r\)\\1 will find two identical lines 
(ending in return character) of text. If the 
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destination expression is \1, the two lines are 
replaced by one, that is the duplicate line is 
deleted. 


Clipboard Related 
\CO ..\C9 Contents of clipboard 0 through 9. 
\CC Contents of current clipboard. 


Both these can be used inside single quotes as the search 
expression. 


Target Expressions 
Almost all the preceding expressions, with their special 
meanings, can be used as part of the target expression (that is the 
expression being searched for). 


When used as targets in macros the following expressions, 


&, \CC 
and all clipboard related expressions, (such as \CO..\C9) 


must be placed inside single quotes. If placed inside double 
quotes they are interpreted Jiterally, because they are not Regular 
Expressions. 


Replacement Expressions , 
Only the following can be used as replacement expressions: 
\I-N9, \cc; NeOu\c9,; &, \b, \f, \n, \r, \s- te NT 


Anything else in the replacement expression will be interpreted 
literally. 


7.4 Repeat Character Examples 


To find a possible plural occurrence of a word, put the “at most 
one occurrence” symbol after the final "s". For example, 


mothers-— 


will match to either “mother” or “mothers”. If a word may be 
followed by a suffix which is longer than one character, 
parenthesize the suffix and follow it by the minus sign: 
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1 
hero\ (es\)- 


will match to “hero” or “heroes”. 


When you aren’t certain how many times in a row a character 
appears, follow it by the plus symbol: 


Help! + 


This would find “Help!” as well as “Help!!”, “Help!!!”, and so 
forth. 


If there might be no exclamation points, you would use an 
asterisk instead: 


Help! * 


This would find the rather meek “Help”, and “Help!”, “Help!!”, 
and “Help” followed by as many exclamations as you care to 
type. 


Remember that when using the repeat character symbols, 
QUED/M will select the longest sequence it finds; searching for 
“Help!*” will find and select “Help!!!” if it is the next 
occurrence of “Help” in the file, ignoring the “Help”, “Help!”, 
and “Help!!” contained as part of it. (If you want to find the 
shortest possible occurrence of a repeat sequence, you should 
use :*, :+, and :- instead of the plain *,+, and -.) 


To designate repeated words use parentheses preceded by 
backslash as grouping symbols. 


Example 6: Find One or More Occurrences 
\(yes \)+ 


(with Whole Word not checked) will find one or more instances 
of the word yes (followed by a space) in a row. (Because a 
space was included in the Regular Expression, the “yes” found 
must be followed by a space, and the space will be selected.) 


Whole Words and Spaces 
Notice that a space was deliberately included after the word 
“yes” in Example 6. This means that the expression will find 
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affirmations like “yes yes yes yes ” but will not select the last 
“yes” unless there is a space following it. 
If we had forgotten the space and instead searched for: 


\(yes\) + 


QUED/M would look for expressions like “yesyesyesyes”, 
without the spaces between the words. 


7.5 Advanced Examples 


Swapping 

The method of parenthesizing subexpressions \(...\) can be used 
to swap complex expressions. Any expressions enclosed by 
backslash-parentheses in the Find dialog can be referred to with 
\1...\9 inside the “Change to” Regular Expression. The Find 
What expression in Figure 8 will find “is box”. The Change To 
expression will then swap the order of the two words to give 
“box is”. 


@Hard Disk:Grep Short List 


Regular Expression 
The following combinations of 
characters have the given 
meanings when the “Regular 
expression” _ in the 


(C0 Whole Word & Regular expression 





Figure 8 


Numbering Parentheses 

Numbering of parentheses is not always what you may expect. 
If “\(abc\)+d” finds the string “abcabed”, then “\l” (in the 
Change To box) would mean “‘abcabe”, NOT “abc”. That is, the 
+ repeat symbol is included with the parentheses, and all repeats 
found will be considered to be part of the first symbol. Using 
nested parentheses, the \1 refers to the outermost one and \2 to 
an inner one, or actually to the second subexpression 
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encountered. For example, if the expression “\(\(abc\)\)+d” 
matches “abcabcd”, then “\1” would refer to “abcabc” and “\2” 
(the inner part) to “abc”. 


It is also possible that expressions like “\1” may refer to more 
than one possible pair of parentheses. This happens if there is an 
OR condition. (Take a deep breath before continuing, as the 
Regular Expressions are about to get hairy.) 


So, if “a\(bc\(.*\)dle\(.*\)f\)g” matches “abcxxxdg”, then “\2” 
means “xxx” and “\1” substitutes to “bcxxxd”. But if it matches 
“eyyyfg”, then ‘\2” means “yyy” and “\l” means “eyyyf”. 
Notice that there are 3 pairs of parentheses, yet “\3” does not 
have any meaning. This is because the “I” caused both the 
second and third pairs found to be assigned the same number 
(because they are on mutually exclusive parts of the Regular 
Expression). 


The & Symbol 
In the substitution expression (the Change To) the ampersand 
symbol "&" means the entire string that was last selected or 
found. 


If you do a Change All (with the Regular Expression box 
checked) of any expression to " &", QUED/M will replace 
whatever matches the expression with itself, in effect making no 
change at all. QUED/M will then show how many 
“replacements” were made. In this way you can count the 
number of occurrences of anything you can describe with a 
Regular Expression. A Change All of 


:d+ 
to 
& 


will count how many integers (not individual digits) are in the 
current file (or files on the search list, if you have set it up). 
More useful is a change all of an expression like 


\<very\> 
to 


& 
which will indicate numerically just how much the word “very” 
is used. Encasing the word in \< and \> symbols ensures the 
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QUED/M won’t count occurrences of “very” in words like 
“silvery”. Alternatively, you can check the Whole Word box. 
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8 USING MACROS 


Macro comes from the Greek word Makros and means “long” or 
“large”. In computer terminology it is shorthand for “macro 
instruction”, and refers to a list of instructions. To automate 
repetitive tasks, QUED/M can create a single command which 
will perform the equivalent of a sequence of key strokes or menu 
selections. Such a single “long” command is called a Macro. 
Many macros are included with QUED/M. You can edit them 
and also create your own macros. 


In QUED/M the macro instructions are typed into a special text 
file, given a name, and saved. Alternatively by entering the 
“Record Macro” mode your actions are automatically recorded as 
instructions. Once saved, a named macro appears as a menu 
item. When chosen from the menu it is executed, it can also be 
executed by other macros. 


Although our macros are very powerful, the first implementation 
of them (QUED/M 2.0X) does not include a complete macro 
language. For example, there is not a way to test the result of 
any action (if...) and act accordingly (then.. .). Future versions 
will have a more complete macro language allowing you even 
more power. 


To use the following sample macros, the macro file supplied 
with QUED/M must be loaded. This is shipped under the name 
QUED/M Macro File. It can be loaded by choosing Load Macro 
File from the File menu. You can tell if it is loaded by looking at 
the Macros menu, if the macro names mentioned below are on 
the menu, the macro file has been loaded. 


Data Base 

You can use QUED/M as a text data base. Since QUED/M 
requires no predefined field structure, it is more flexible than a 
specialized data base program. For many searches QUELD/M is 
faster than a data base program. You should make sure that each 
file is no bigger than about 200K, or about 100 single-spaced 
pages of text. You can use any number of files, so the amount of 
data QUED/M can manage is effectively limitless. 


One of the more useful features of QUED/M for datz base 
applications is its ability to perform searches through unopened 
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files. This allows you to perform data extraction from any 
number of files with one macro. You can also: 


* Find facts (such as words or phrases) in unopened 
files (by doing a Multifile Search). 

* Create a list of files containing the given facts (with 
the List Subject Files macro). 


This makes it easy to organize your data base in files, each of 
which contains information on one topic. The way you split up 
your topics is of course up to you. 


Example 7: Text Data Base 

You are in business selling various widgets to customers all over 
the country. You can use QUED/M to keep track of your 
customers. We will assume that you anticipate having 10,000 
Customers and need to keep records of each customer’s name, 
address, item purchased, date of purchase, and the customer’s 
company affiliation. You may also want to type in special 
comments about each customer. 


First decide the format of each record. In the macros we have 
supplied we assume the following record structure: 


First Name, Last Name 

Street Address 

(Suite or Apartment number, if any) 
City 

State (2 letter code), Zip Code 
Product name or code 

Company name 

Phone number (212) 111-2222 
Comments 


First Name, Last Name 

Street Address 

(Suite or Apt Number) 

City 

State (2 letter code), Zip Code 
Product Name or code 

Company Name 

Phone number (313) 444-5555 
Comments 


In our example format a different number of lines for each 
record can be used, but a blank line must separate each record 
and no blank lines are allowed inside a record. Comments can 
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have any number of consecutive lines. Suite or apartment 
number, company name, and phone number lines are optional. 
The Zip Codes can be either 5 or 9 digits. 


You now decide to have 26 files for all your customers, one file 
for each letter of the alphabet. Assuming about 100 characters on 
average for each record, 10,000 customers would use up just 
short of one Megabyte. If these are distributed evenly 
throughout the alphabet, which is unlikely, each file would be 
about 40K. This is quite small and manageable even on a 512K 
Macintosh. If some files are even 7 times as big (280 K) they 
can be handled on the Macintosh Plus. As a file starts to get 
large, simply open up another file in the same alphabetical 
group. There is no disadvantage to having more files. You may 
also consider categorizing by region, state or country to fit your 
requirements. 


You should decide at the outset on a naming convention for 
your files. For your convenience the file names should convey 
some information, such as the first letter of the last name of the 
customer. A suitable method (of allowing for expansion of files) 
is to end each of the original file names with the number 2. 
When one becomes too large, create a new file with the same 
name but ending in 2, and so forth. 


Using the Data Base 
Having typed in your data (or having transferred it from a word 
processor or data base program), you will want to be able to find 
a Customer by name. If they are customers grouped in files by 
last name, not many files will be searched. First select the files 
you want searched. This is done as follows: 


Adding to the Search List 

* Choose Open from the File menu. 

* Select the files you wish to search. 

* In the Open dialog choose Add to Search from the 
Other menu (Figure 2). The file or files selected will 
be added to a search list. (The files do not have to be 
opened to be searched). Repeat this procedure until 
all of the files you wish to search are marked with an 
“eye” icon. 


Finding Names 
¢ Choose Find from the Search menu. 
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* Type in the name as you think it was entered in the 
data base. 

¢ Be sure to check that the Ignore Case and Whole 
Word options are appropriately set. 

¢ Click Find Next. 


QUED/M will search all the files on the search list, whether 
opened or not, as well as the active opened file. It will not search 
any other opened files unless they are on the search list. If 
QUED/M finds the name in a closed file, it will open it and select 
the name. 


. Searching with “Or” 
There will be times when you are not sure of the spelling of a 
name. In that case you should check the Regular Expression box 
in the Find dialog and use the vertical bar (I) as an “or” to check 
several alternatives at once. (See Section 7.2 on the “on” 
metacharacter.) Part of a name can also be searched for, 
provided the Whole Word option is turned off. 


Mail Merge 
You may need to create a list of names and addresses of all your 
customers in a format suitable for use by a mailing label program 
or for doing a mail merge. 


Choose the macro called “Address List”. This will extract a list 
of names and addresses from all the files in the file list, and put 
them in a new file called “Address List File”, which is in the 
current folder. The data will be arranged in the same format as it 
was in the source file. Each address will be separated from the 
others with a blank line. If you want to have each field, or line, 
of the address separated by commas rather than Returns (ready 
for use by a label printing program or a data base program),, 
execute the macro “Data Base Convert”. 


Phone List Extract 
If you want to extract a telephone list from your data base, select 
the files you want to search, as before, and choose “Extract 
Phone List” from the Macros menu. This will produce a phone 
list in a file called “Phone List”. It will be alphabetized by last 
name. 


If you want a listing of all the customers from a particular state, 
use the “Extract State” macro . Remember to copy the two letter 
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state code into the clipboard before executing the macro. 
Alternatively, you can edit the macro. To search for one 
particular state, change the single-quoted expression \CC' in the 
macro to the appropriate two letters of the state code. Put the 
state abbreviation in double quotes, like "NY". 


Appointment Book 
It is unlikely that an appointment book will be a very big 
document, assuming that you clear out your old appointments, 
one file should be sufficient. Here is one method of keeping an 
appointment book. 


Open a file, name it “Appointments”, and type your scheduled 
appointments into it using the following format: 


TIME DATE ACTIVITY 


10:00 AM 8/11/88 MacWorld Boston 
PM 4/12/88 Meet with accountant 
:30 AM 6/15/88 Dentist 

:PM 8/01/88 Sue & Bob Wedding 

:15 AM 7/12/88 Board Meeting 
2:59:30 PM 7/04/88 Start Fireworks 
:00:01 AM 6/12/88 RBS test start 
2:00:01 PM 6/12/88 RBS test end 
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Type the time and date in the format shown. The separator 
between the hours, minutes (if any), and seconds (if any) must 
be a colon. If only the hour is specified, no colon is necessary. 
The information about the appointment follows the time and date 
on the same line. You can have any amount of information about 
the appointment, but it must be contained in one paragraph only. 
That is, you must press Return only when you have finished one 
appointment and are ready to enter the next one. You should 
choose Set Line Width (in the Format menu) for ease of reading. 
A line width of about 50 characters will probably be appropriate. 


To retrieve the appointments for the day, open the 
“Appointments” file. Execute the “Appointments” macro and 
you will see the appointments for today listed by order of time in 
a new file called “Schedule MM/DD/YY”, where MM/DD/YY is 
the current date. 


At the end of the day you can use the “Archive Appointments” 
macro to remove the day’s appointments from the current 
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“Appointments” file and put them into an “Old Appointments” 
file. Make sure that the needed files are listed (not selected or 
opened, only listed as being in the current folder) in the Open 
dialog before you run the macro. 


File Catalogs 
You can create catalogs of files and directories by copying the 
lists from the Open dialog (choose Open and the dialog will 
become the top window from which you can copy) and pasting 
them into a catalog file. If you want to create a complete catalog 
showing the full path to each file, do the following: 


* Select the files you want added to your catalog and 
add them to the search list. They will appear with an 
“eye” icon. 

¢ Open and name the catalog file. 

¢ Execute the “Get File List” macro. 

¢ Paste into the open catalog file. 


The macro lists the full paths to all the files on your search list, 
in the current clipboard. When you choose Paste from the Edit 
menu, you will in fact be pasting this list into the active file. 


Bibliography 
This is really a specialized data base. In deciding how you want 
your bibliography files grouped, consider how you will be using 
it. If your most common search involves finding bibliography 
topics, then group entries by topic. Appropriate grouping will 
allow for faster searching later. You do not have to group the 
entries at all, you can always search through all of your files. 


Here are some grouping possibilities: by topic, date, name of the 
first author, by journal, or no grouping at all. Whether you 
group or not, for maximum flexibility, keep your file size below 
about 200K. 


If you are not sure of the ultimate size of your file, and you 
anticipate being able to write your own macros, then you can 
initially use one file without any special organization. Later 
when you want to group them, this can be done with a macro 
which you will have to write. 
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Type your references as you would on cards, using one line per 
field”, in a manner similar to the customer data base example. 
Insert a blank line between references. 


To help in determining your needs the following are some 
typical numbers: 


Typical number of characters per reference: 250 
Number of references per 200K file: 800 


Here is an example of a suitable format: 


Vanlubskii, Igor et al. 

A New Compaction Algorithm 
Programming, Software, Text Compaction 
Proc. Comp Soc 12, 5, 112-134, 1976 
New compaction algorithm for text is .. 


The first line for the author, last name first, with multiple 
authors following. The second line is for the title. The third line 
lists key words which are not in the title of the publication; not 
all publications need this. Next is the line with the name of the 
publication and the usual references. The last line (or 
paragraph), which can be as long as you like (but to read it you 
should set the line width to the screen size), can contain as long 
a description of the article, book or other publication as you 
think is necessary. Clearly, the more descriptive information you 
add the more space it will take. 


To find an article with a key word simply add the files you need 
to the search list and choose Find, type in the key words, and 
click Find Next. 


You can search for several alternatives by using the Or 
metacharacter, “I”, to separate them. To look for any one of the 
words programming, software, text, and compaction, the 
following expression should be typed into the Find dialog, with 
the Regular Expression and the Whole Word options activated. 


programming|software|text | compaction 


An Extract References macro is supplied with QUED/M. This 
macro searches through the files on the search list and extracts 
all the references which have the given keywords mentioned. 
The required key words have to be typed in or copied to the 
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current clipboard before the macro is executed. Multiple 
keywords should be separated by the “” metacharacter and there 
must not be a Return in the clipboard. The extracted list is placed 
in a new file named for example, 


Ref 9:35:05 PM 5/19/97 
where the time and date are those current at the time of creation 


of the file. The list is ordered alphabetically by the last name of 
the first author of each entry. 
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9 LEARNING TO PROGRAM MACROS 


We remind you here of the symbols used in this manual for the 
modifier keys: 


3% = Command 
@ = Shift 
& = Option 


This section explains how to write, edit, and execute macros, 
and how to install them into the QUED/M menu. 


Although we have included many powerful features in 
QUED/M, you may find yourself occasionally wanting some 
capability we had not thought of. Learning to write macros will 
enable you to tailor QUED/M to suit your special needs. Once 
written, macros are available as menu choices, just like the 
standard features of QUED/M. 


Macro Files 

Macros are stored in macro files. Each macro file can hold any 
number of individual macros. When you write your own 
macros, you should group them in files according to their 
function. For example, macros useful for writing letters and 
papers should be together in one file, and macros appropriate for 
writing programs should be in another. Only the macros in one 
file are available at one time via the Macros menu. If you want to 
use the macros in another macro file you must first load that file 
(use Load Macro File from the File Menu). 


The macros we have included with QUED/M are stored together 
in one file but can be split into separate files. 


Load Macro File 
To use a set of macros, you must tell QUED/M to load the macro 
file in which they are stored. QUED/M can only load one macro 
file at a time. When you load a macro file, it becomes the one 
currently available in the Macros menu and any previously 
loaded macro file is unloaded. 


* Choose the Load Macro File... item from the File 
menu. 
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The File dialog (Figure 2) will be brought to the top (if not there 
already) and will show the macro files and folders only. (This 
dialog is like the normal Open File dialog but with one 
difference, it shows the word Load in place of the word Open in 
the default button.) 


* Find the macro file you wish to load, select it, and 
click the Load button (or double-click its name). 


This loads the selected macro file and places the names of all the 
macros within it on the Macros menu, below the “Assign Menu 
Keys...” item, Check the list of macros on the open Macros 
menu. 


New Macro File 
To create a new macro file: 


* Choose Load Macro... as for loading a macro file. 
* The File dialog has a submenu marked Other.... 
Choose New from the Other... submenu. 


Another file dialog comes up asking for a name for the new 
macro file. 


¢ Type a name of your new macro file. 
* Click on the Name button. 


You have opened a new macro file and any new macros you 
now Create will be stored in this file. Any macro file you had 
previously has been unloaded. 


If you have no macro file loaded (you will know this because no 
macro names are listed below the “Assign Menu Keys...” item 
in the Macros menu) writing a macro will automatically create a 
new macro file called QUED/M Macros, in the folder which 
holds QUED/M. 


Automatic Load Macro File 
If there is a macro file named “QUED/M Macros” present in the 
same folder as QUED/M, it will be loaded automatically when 
QUED/M is started. 


QUED/M is shipped with one macro file called ““QUED/M Macro 
File”. If you want to have it load automatically then you must 
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rename it “QUED/M Macros”. If you are going to try typing 
(creating) some of the macro examples, you should start without 
any loaded macro file. 


Macro files are text data files and have a distinctive icon. Initially 
only one macro file is present (the one provided with QUED/M), 


_ and so it will be the only one shown in the file dialog when you 


try to load a macro file. When you create new macro files they 
will also appear in the file dialog when you choose Load Macro 
File. 


Macro Names 
Make sure you pick a unique name for each macro iii one macro 
file. If it coincides with another menu item name (0a any of the 
menus, including the Apple Menu), you will not get consistent 
results when you try to invoke it from another macro unless you 
precede its name with the name of the menu (as in “Macros: Your 
Macro”). Macros can invoke other macros by name, and they 
can also invoke themselves. In this latter case the macro 


continues looping until either you stop it (with 9.) or you have 
written it so as to stop the macro (using the "T" argument) when 
the search fails. 


Editing Macros 
By choosing the Edit Macro item in the Macros menu you can do 
the following: 


¢ Edit an existing macro. 
¢ Delete an existing macro. 
¢ Create a new macro (not a new macro file). 


You will get a dialog as shown in Figure 9. 


The default name of the macro is always “my macro”. It is 
automatically selected so that all you need to do is type in the 
name of the macro and press Return. Instead of typing in the 
name of an existing macro, you can also choose it from the 
Macros menu, and its name will be entered into the dialog box. 


Macro name: 


(Cra) 


Figure 9 





If the name you have entered is one of the macros in the 
currently loaded macro file, you will see the text of this macro in 
a special macro editing window. It functions like an ordinary file 
editing window, but it has a black, rather than striped, title bar. 
With the macro editing window open, QUED/M is ready for you 
to type in (or record) a sequence of instructions. (These are 
explained later in this section.) This window is small because 
you will often need to see what is behind it, but you can resize it 
like other windows. Although it lacks a zoom box, you can 
zoom the macro editing window to full size by double-clicking 
on its title bar. 


If the name you have entered is a new name, you will get an 
empty window ready for creating or recording a new macro. 


9.1 Recorded Macros 


Record Macro 
The easiest way to create a macro is to have QUED/M record 
your keystrokes. The resulting macro, when executed, will 
reproduce the recorded keystrokes and menu choices. 


Choosing Record Macro causes QUED/M to record your 
keystrokes and menu choices (in the top window). When 
chosen, the following things occur: 


¢ The Record Macro menu item changes to Stop 
Recording. ‘ ; 

¢ All menu items become enabled, allowing for their 
selection. ; ; 

* The top window (the one currently being worked in) 
becomes the recording window, in which the macro is 
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recorded. The text of the recorded macro will replace 
and text selected. If no text is selected, the recording 
_ will begin at the position of the current insertion point. 

* Choosing any menu item will put its name on a line in 

_ the recording window. Typing text will enter the word 
“Key” followed by the text into the recording 
window. Pressing the Return key will enter the word 
“Key ” alone on a line. 

¢ If another window is brought to the front, menu 
choices and typing are recorded in the recording 
window but executed in the top window. Macro 
recording is usually done by typing and choosing 
menu items in a window other than the recording 
window, so that the effects of the actions are 
immediately apparent. 

* To stop recording, either to edit out a mistake from the 
recording window, or when finished, choose Stop 
Recording. from the Macros menu. The macro 
window will become the top window. To continue 
recording, place the insertion point at the appropriate 
place in the Recording window, and choose Record 

again. ; ee 


Pressing the delete key while recording causes a “delete . 
character” (generally a small rectangle) to appear in the macro 
window. (If you want to edit a part of the recorded macro, you 
must stop recording before using the backspace key.) Other 
“characters” such as the arrow keys and the clear key, also 
appear as rectangles on the screen. You can remove any 
unwanted characters with standard QUED/M editing techniques 
but you must first stop recording! : 
If during recording, any modifier keys are held down while 
menu choices are being made, indicators for those keys will also 
appear at the beginning of the line of the with the menu title. The 
3% symbol will appear for the Command key, the symbol for 
the Option key, and the symbol for the Shift key. These 
symbols are visible on the screen in the Chicago font. In other 
fonts, they will probably appear on the screen as small 
rectangles, but will still work in the macro. For example, if the 
command and option keys were held down while Show All 
Hidden Text is chosen from the Format menu, the macro 
recording for that action would be: 
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9 Gsnow All Hidden Text 


QUED/M does not check if any special meanings are attached to 
the modifier keys when recording a macro. In this case, holding 
down the command and option keys does not alter the effect of 
choosing Show All Hidden Text, but QUED/M nevertheless 
records the fact that command and option were held down. 


In the recorded macro, any text entered appears following the 
word “Key ”, and a press of the Return key appears as a line 
with just “Key ” on it (note the space after the word key in both 
cases, and that the k is capitalized). If the command key is held 


pressed while typing a letter, the symbol 9% will appear before 
that letter in the recording. 


Desk Accessory Menus 
If a desk accessory is used while recording a macro, text typed 
into the desk accessory will be recorded, but menu choices from 
any menus belonging to that desk accessory will be ignored. 
Desk accessory menu choices can be typed directly into the 
macro after recording. 


Macro recording is most often used for entering macro lines 

which include modifier symbols or invisible characters (such as 

the command or option keys). It is generally quicker to type in 

macros directly, using macro recording only occasionally, 
_ particularly when the special symbols are needed. 


These special symbols can also be entered through the ENTER 


ASCII table. They are listed in the manual under Notation. We 
repeat them here for your convenience. 


i a 


# 11 017 Command 
é& 14 020 Option 

e 13 019 Shift 

none 1C 028 Left arrow 
‘none 1D 029 Right arrow 
none 1E 030 Up arrow 
none 1F 031 Down arrow 


zooonoooogoo000 
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Example of a Recorded Macro 
Example 1 shows how simple a useful macro can be. 


Example 1: Exchange Macro 
If you are a fast typist, or a clumsy one, or perhaps have a tinge 
of typing dyslexia, you will catch yourself transposing the 
position of some characters. To fix this it would be useful to 
have a command which swaps the positions of two characters. 


¢ Choose Edit Macro... from the Macros menu. 
¢ Type in a name for the macro (like “Swap Char’) into 
the dialog box and click the Edit button. A special 
macro window (with a black title bar) will open. 
e Choose Record Macro from Macros menu. 
¢ Type the following key strokes: 
command-shift-space 
command-x 
command-space 
command-v 


(These are all typed without a Return between them.) You will 
see the following line in the special macro window 


Key 6@ Hx &H Hv 


¢ Choose Stop Recording from the Macros menu. 
¢ Click the close box of the special macro window, and 
click “Yes” when QUED/M offers to save the macro. 


Your new macro should now appear at the bottom of the Macros 
menu. Choosing it should swap the two characters to the right of 
the insertion point. Section 11.9 explains how to assign a 
command key equivalent to the new macro, allowing you to 
invoke it without using the mouse. 


Example 1 Explained 
This macro replicates a pattern of keystrokes which would swap 
any two characters to the right of the I-beam. 


Key stroke Comment 

%@space QUED/M key to select the next character. 
x Cut the selected character 

# space QUED/M key to skip over next character 
ev Paste cut character in new position. 
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You can see how this macro works by placing the insertion point 
before two characters, and typing the keystrokes directly. Watch 
what QUED/M does after each key. 


Example 2: Letter Template Macro 
It is easy to record a macro which, when invoked, will type your 
address into a new file, ready to be followed by a profound and 
touching personal note. : 


¢ Choose Edit Macro from the Macros menu. 

¢ Type a name for the macro (like “template”) and press 
Return. A new macro window will open. 

* Choose Record Macro from the Macros menu. 

¢ Click into the text file window (that is, activate some 
window other than the macro editing window). 

¢ Choose New from the File menu. 

¢ Enter a name for the new file, “untitled letter”, and 
press Return. (Do not click on the name button in the 
dialog, use the Return key.) } 

* Type your name and address into the new file 
window. If you make a mistake, do not try to correct 
it — do not even press the Backspace or Delete key. 
Leave all corrections until you have finished 
recording. — 

-e After you have typed in your name and address, 
choose Stop Recording from the Macros menu. The 
macro editing window should return to the front. 


You should see something similar to the following in the macro 
window: 


New... 

Key untitled letter 
Key 

Key Jane Elizabeth Doe 


Key 

Key 1412 Shady Lane 

Key 

Key Upper Rocktown, MA 02120 


Now go back and correct any errors in the macro editing 
window (not in the new file window which is no longer 
connected to the macro you have recorded.) You can edit the text 
in a macro window just as you would in a normal QUED/M text 
window. 





m 
i 
“ 
am 
= 
m2 
m2 
rm 
[2 
2 
= 
MH 
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You can now save the macro by clicking the macro window 
close box, and clicking the “Yes” button when QUED/M offers 
to save the changes. 


Note that we did not have to record this macro. After opening 
the macro editing window, we could have just typed in the 
macro as it appears now. Whether a macro is typed in directly or 
made by recording has no bearing on what it will do. . 


Example 2 Explained 

The macro command “Key ” (do not forget that there must be a 
space following the word Key, and the K must be a capital 
letter) means that everything following it on the same line is to 
be treated as if it was typed in at the keyboard. A single word 
“Key ” on its own line (with the obligatory space after the 
word) is equivalent to typing a Return. 


Lines beginning with something other than “Key ” are treated as 
menu choices. You can type in menu choices even for menus 
which are not a part of QUED/M. Thus in a macro you may 
choose from a menu in an open desk accessory. 


Here is the line by line explanation of the example. 


¢ The “New” command is the same as choosing New... 
from the File menu. The three dots are optional in a 
macro, although if they are typed in manually (as in 
editing the macro) they must be typed as option- 
semicolon, not as three periods. 

¢ “Key untitled letter” types the name ‘untitled letter’ 
into the new file dialog. 

e “Key ” alone on the next line is like pressing Return 
into the file dialog. It tells QUED/M to make a new 
file with that name. 

¢ The next lines are the keyboard entry equivalents of 
the name and address. Each line of the address is 
followed by a Return, and so the word “Key ” is 
needed alone on a line after each line of the address. 


You can follow the same procedure to record any number of 
such “keystroke” macros. We have listed all keyboard 
commands in Section 12. QUED/M offers many extensions of 
the standard Macintosh keyboard equivalents. These include 
Command-Shift- Return to select up to the next return character 
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(an explicit, typed end-of-line or end-of-paragraph), and 
‘Command-Option-<Space> to place the I-beam after the next 
word. These equivalents are often useful in writing macros, as 
the next example shows. 


Example 3: Replace Macro 
Here is an example of a macro using keyboard equivalents for 
Find and Close, 
Key %fParagon Courseware — 
Key 
Key %¢. 
Key Paragon Concepts Inc. 


This macro will search for the words “Paragon Courseware” and 
replace them with the words “Paragon Concepts Inc.” 


Example 3 Explained 


“Key 9 fParagon Courseware” opens the Find dialog and types 
“Paragon Courseware” into it as the search string. (Notice that 


the 96 f is lowercase; 96F has a different meaning.) - 


The next “Key ” command, like pressing Return, causes 
QUED/M to find and select the next occurrence of the string. 


“Key 9.” is a keyboard equivalent of clicking the close box of 
the top window, which is the Find dialog window at this point. 
Finally, “Paragon Concepts Inc.” is typed, replacing the 
selected “Paragon Courseware”. 


Example 3 could equivalently be written with explicit menu 
choices given, rather than with key equivalents. The Record 
Macro facility works just as wellin this case. 


Find... . 

Key Paragon Courseware 
Key 

Close 

Key Paragon Concepts Inc. 


The macro recording facility cannot record mouse movements or 
clicks, closing windows while recording a macro should 
therefore be done by choosing “Close” from the File menu, or 
by pressing Command-Shift-period. Similarly, when recording 
a macro, use the Return key for dialog boxes rather than clicking 
the default button. See Section 12 for other keyboard 
equivalents. 


Ld 
am 
m 
m 
m 
m3 
m3 
m3 
m3 
i 
m 
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9.2 Typed Macros 


Macros are most often typed in manually, rather than recorded 
by QUED/M. All of the previous examples of recorded macros 
could have been typed in directly. ° — - 


To create a typed macro, choose Edit Macro from the Macros 
menu, type in a name, and press Return. A macro window will. 
open up, into which you can type the macro. At any point in 
writing a macro, you may choose to record one or more lines in 
the following way: 


¢ Place the I-beam in the macro window where you 
want the recording to be placed. 

e Choose Record Macro from the Macros menu, and 
proceed as was shown in Section 9.1. 

¢ Stop Recording and proceed to finish typing the rest 
of the macro. 


’ 


_’ Example 4: Using Open 
A macro which will open an existing file called “Notes” from the 
current folder looks like this: 


Open “Notes” 


When executing this macro, QUED/M will look for the file 
called “Notes” in the current folder. The current folder is the one 
which is showing in the File dialog window. (Choose Open... 
from the File menu to see this dialog). If the file requested is not 
in that folder, you will get an error message. If the file is in a 
different folder or on a different disk, you must specify the path 
name for an Open to be successful: ‘ 


Open "HD20:Notes Folder:Notes" 


Each folder name is separated from other folder names and from 
the disk and file name by acolon, — 


Arguments 
An expression in quotes immediately following a menu item 
name is called an “argument”. Arguments are generally used in 
writing macros to simulate the effect of mouse clicks. By not 
having to describe mouse actions, macros are kept short. 
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_ The effect of typing into dialog boxes can also be accomplished 
_ by using arguments. Arguments can be used following many 
menu item names. They can specify what to search for, what to 
replace the found expression with, how a search is to be carried 
out, and the state of various “toggles” (such as Ignore Case, 
Global Search, and Regular Expression). 


Example 5: Opening a Folder 

- This macro will open the folder “Special Files” which is (or 
should be, for this macro to work) located inside the current 
folder. 


Open "Special Files" "C" 


This macro has two arguments, “Special Files” and “C”. The 
first argument is the name of what is to be opened; the second 
argument indicates that a folder is to be opened, rather than a 
file. "C" is short for “Change folder”. If you left out the "C" 
argument, QUED/M would look for a file called “Special Files” 
in the current directory. It is important to note that the Open 
dialog must in fact be Open (that is it must be the top window) 
for this macro to work. If you want the macro to work when the 
Open dialog is closed you should precede the first statement with 
the word Open: 


Open 
Open “Special Files" "C" 


When typing in this macro, be sure to include the quotation 
marks. Also notice that plain quotation marks are used in 
macros, rather than the “open” and “close” quotes that the 
Macintosh provides. (The plain quotation marks, "", appear 


when you type Shift-quote, and the open and close quotes, "", 
are entered by Option-[ and Shift-Option-[ respectively.) 


Example 6: Using New in Macros 
This macro will open a new file in the current folder and name it 
“Today’s Notes”. 


New "Today’s Notes" 


When it executes this macro, QUED/M will open up a new 
window on the screen, ready for typing. If you want to open a 
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new file in a folder other than the current folder, you would 
combine the follgwing macros: 


Open "Special Files" "Cc" 
New “Today’s Notes" 


These macro statements make the folder “Special Files”, which 
should be inside the current folder, become the new current 
folder, and will create a brand new file called “Today’s Notes” 
inside of the “Special Files” folder. 


Example 7: Setting the Font 
Before creating a file you may want to choose which font and 
point size the file should use. To achieve this, specify it in the 
macro, as shown. 


New "Martian Psalms" 
24 Point 
Helvetica 


This macro will create a file called “Martian Psalms” in the 
current folder and set its window to 24-Point Helvetica. 


Example 8: Literal Find 
The command: 


Find "macintosh" “i-g" 


This will search through the current window for the word 
Macintosh, starting at the location of the insertion point, or from 
the end of the current selection. The first part of the second 
argument, "i", tells QUED/M to ignore the case of the characters 
when searching. Using "i" is like checking the Ignore Case item 
in the Search menu. The second part of the second argument "- 
g" ensures hat the Regular Expression box, if checked, is 
ignored. 


9.3 Argument Syntax in Macro Language 


Macro commands make up a very simple programming 
language. Placing a menu item name on a line in a macro is 
equivalent to choosing it from the menu. Some menu items bring 
up dialogs which normally need entries from the keyboard. In a 
macro you can avoid the necessity of keyboard entry by using 
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quoted expressions following some menu items. These quoted 
expressions are called “Arguments”. 


Menu items can take none, one, two or three arguments. The 
first argument can be any expression. The last (in all cases 
except the “Change...” menu item) can be a combination of 
single character expressions listed later in this section. Be very 
careful when deciding which argument to include in a macro 
command. Small changes in arguments can make a big 
difference in what a macro does or does not do to a file. 


In this section we define the syntax and meaning of those macro 
commands which can be used with arguments. Note that all the 
arguments in what follows are enclosed in double (plain) quotes. 
If you need to use double quotes inside any of these 
arguments you must double them up. 


For example, to find the phrase “name is "QUED/M" now” you 
would type: 


Find “name is ""QUED/M"" now" 


Single (plain) quotes may also be used but they have very 
special meanings. Expressions in single quotes will be 
interpreted first, then the command will be translated (parsed) 
and executed, and if the “Regular Expression” toggle is turned 
on, the arguments will be interpreted once more during Parsing. 
For a more detailed explanation of the effect of single quotes and 
examples see Section 9.8 “Search Argument Interpretation”. 


Macro Command Format 

In what follows we first list the format of the various macro 
commands and then explain each in turn. All quoted words in 
capitals stand for expressions which can have many different 
forms and which can control the macro command. The word 
“TARGET” stands for the expression being searched, whereas 
“DESTINATION” stands for the expression used to replace the 
TARGET. The “OPTIONS” part consists of a combination of 
characters (called “Arguments”) which are used to control the 
execution of the macro command. All the possible arguments 
are listed in what follows. 


Change "TARGET" "DESTINATION" "OPTIONS" 


ZUOODCRCAGaeooODL 


Close "TARGET" 

Copy "DESTINATION" "TARGET" 

Cut "DESTINATION" 

Find "TARGET" "OPTIONS" 

Jump "MARKER NAME OR LINE NUMBER" 

Jump "START MARKER/LINE" "END MARKER/LINE" 
MENUITEM "On" 

New "FILE NAME" 


_ Open "TARGET" "OPTIONS" 


Paste "DESTINATION" "TARGET" 


Paste "DESTINATION" "TARGET" 

Save As "FILE NAME" "" 

Save "FILE NAME" 

Set Marker "FIRST MARKER" "SECOND MARKER" 


Change "TARGET" "DESTINATION" OPTIONS" 

The TARGET and DESTINATION can each be any regular 
expression or literal string. Note however that very few 
metacharacter expressions can be used as destination strings (see 
Section 9.4 Macro Argument Listings). The only metacharacter 
expressions allowed in the destination string are those which can 
be interpreted without any ambiguity. Thus, for example, 
character classes (such as “:d” for digit or “:a” for alphabetic 
character) cannot be used in the destination expression. 


The OPTIONS argument can be omitted, but if present can be 
any number of characters each of which determines the setting of 
the various “options” such as whether the Regular Expression 
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box is to be checked, whether the whole word box is to be 
checked, etc. 


For better readability you can place the word “to” in between the 
“TARGET” and “DESTINATION”. (It has no effect on the 
macro). For example, 


Change "this" to "that" "-g-Awa" 


will change all occurrences of the word “this” to the word “that” 
Starting at the current insertion point through to the end of the 
file. See Section 9.8 for more examples of the use of Change in 
macros. 


Close "TARGET" 
The TARGET is any legal file name which is open at the time of 
execution of the command. Thus the macro, 


Close “Notes File" 


would close the file named “Notes File”. If the file is not open, 
the command would be ignored. Note that if the file had been 
changed and not saved, the macro would get interrupted by the 
usual dialog asking if you wish to save changes. To avoid such 
interruptions, you could preceded the “Close” command with the 
“Save” command: 


Save "Notes File" 
Close "Notes File" 


Copy "DESTINATION" "TARGET" 

This command places the TARGET into DESTINATION. 
DESTINATION can be any single digit which stands for the 
corresponding clipboard number. TARGET is any text 
excluding the Return character. For example, 


Copy "2" "Paragon" 


will place the word “Paragon” in clipboard 2. If DESTINATION 
is omitted, as in 
Copy "" “TARGET” 


the TARGET is copied into the current clipboard. If the 
TARGET is omitted, as in 
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Copy "3" 


the selected text is copied into the appropriate clipboard 
(clipboard 3 in this example). 


Cut "DESTINATION" ; 

DESTINATION can be any single digit which stands for the 
corresponding clipboard number. The current selection is cut 
and placed in the destination clipboard. For example, 


Cut "5" 
will cut the currently selected text and place it in clipboard 5. 


Find "TARGET" "OPTIONS" 

TARGET is any regular expression or literal string. It cannot 
include a literal Return. If the return character needs to be 
included you must use the metacharacter “\r” to represent it and 
then the “g” (regular expression) must be included in OPTIONS. 
The OPTIONS argument need not be present, but if present it is 
similar to the “Change” options. For example, 


Find “super” "iwT" 


will find the word “super”, without distinguishing upper and 
lower case characters, and only if it is a whole word. It will not 
find “superlative”. See Section 9.8 for more examples. 


Jump "MARKER NAME OR LINE NUMBER" 
Jumps to the quoted marker name or if a number, to the | 
beginning of that line number. For example, 


Jump "120" 


will jump the beginning of line 120. If the last line in the file is 
less than line 120, it will jump tp the last line of the file. 


Jump “read this later" 


will jump to the marker called "read this later“. If there is no 
such marker in any open file, the command will be ignored. 


Jump "START" "END MARKERI/LINE" 
This selects the text between the quoted markers or line 
numbers. (Marker names must not be numerical). For example, 


Jump "3" "12" 


will select the text from the beginning of line 3 to the beginning 
of line 12. 


Jump "3" “mark this" 


will select the text from the beginning of line 3 to the marker 
named “mark this”. 


MENU ITEM "On"; MENU ITEM "Off" 

MENU ITEM stands for any menu item which is a “Toggle”. 
Each such item appears on the menu in italics. “On” means item 
to be checked and “Off” means item to be unchecked. For 
example, 


Clipboard “On" 


will bring the clipboard to the front. If it is already in the front it 
will do nothing. 


New "FILE NAME" 
FILE NAME can be any file name including the path if 
necessary. To specify the path, the format is: 


Disk name:Outer folder Name:Inner folder name:File name 


Open "TARGET" "OPTIONS" 
TARGET is either a file name (with path included as in “New” 
above) or a folder name (also with possible path included, but 
with no file name ending it). If it is a folder (not a file) the 
OPTIONS argument must be the single character “C” and the 
command means “Open the quoted folder”. The special 
command 


Open ";;" "Cc" 


means move up to the parent directory. When the TARGET is a 
file name, the options argument can be omitted and the command 
simply opens the given file. If the file is already open it is 
brought to the front. If OPTIONS is the single letter “A” the file 
is not opened but is added to the search list. If “A” is replaced 
by “R”, it is removed from the search list. For example, 


Open "Notes File" "A" 
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will add the file called “Notes File” in the current directory to the 
search list. 


‘Open “Notes File” "R" 
will remove this file in the current directory from the search list. 


Paste "DESTINATION" "TARGET" 

When DESTINATION is the empty string, this replaces the 
selected text with TARGET. DESTINATION is a digit 
representing the clipboard to’ be used. When "TARGET" is 
omitted completely, the contents of the DESTINATION 
clipboard are pasted into selection. For example, 


Paste:'"" “Address” 


will replace the selected text with the word “Address”. 


@Paste "DESTINATION" "TARGET" 
Appends the selected text into DESTINATION clipboard and 


then pastes TARGET into selection. The “®” means “Shift”. 


Save As "FILE NAME" "" 

Renames the current file as FILE NAME but does not save it. If 
the last pair of quotes is omitted, it saves the current file under 
the FILE NAME. 


Set Marker "FIRST MARKER" "SECOND MARKER" 
If the second quoted expression is omitted completely, the 
FIRST MARKER will be placed at the insertion point, otherwise 
FIRST MARKER is placed at the beginning of the selection and 
SECOND MARKER is placed at the end of the selected text. 


9.4 Macro Arguments Listings 


Arguments used with Find and Change 
These macro arguments should appear together (if there are more 
than one) inside a pair of double quotes, after the macro 
command and any file name arguments. Examples are given in 
the following section. ; 


A Auto wrap. Similar to setting Auto Wrap 
item in Search menu. 


-A 


-M 
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Turn off Auto Wrap. 


Change All similar to clicking Change All 
in Change dialog. 

Enter arguments into Search dialog but do 
not perform a Find or Replace. For 
example, Find "good" "C" will enter the 
word “good” into the Find dialog. 

Go to end of text if search fails. 

Search for Regular Expressions similar to 
checking the Regular Expression box in 
the Search dialog. 


Search for literal matches, not for Regular 
Expressions. 


Search for Regular Expressions similar to 
checking the Regular Expression box in 
the Search dialog. 


Search for literal matches, not for Regular 
Expressions. 


Global search, search all open files. 


Turn off Global search, search only top 
file. 


Ignore Case when searching. 
Change All in selected lines. 


Multifile search, if a file list has been 
created. 


Turn off Multifile search. 


Multifile search, if a file list has been 
created. 


Turn off Multifile search. 
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r 


Example 9: Use of Arguments with Find or Change 
macro: 


The one line 
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Select last change when finished 
changing within a selection. 
IAN Rap yim — 


Change All in selection, similar to 
holding down the option key when 
clicking Change All. 


Terminate current macro if search fails. 


Terse answers, means do not display 
Pattern not found” dialog, or the 


| “Number of expressions replaced” dialog 


Verbose answers means it will display the 
sepa of substitutions” after a Change 


Auto Wrap. Similar to setting up Auto 
Wrap item in Search menu. as 


Turn off Auto Wrap. 


Whole word searching similar to 
checking the Whole Word option in a 


Search dialog 


Partial word searching, do not restrict 
matches to complete words. 


List the paths to the files in which the 
ry pe hog my argument) is found, 
it is used only with Find, and with a fil 

Search list selected. ‘ 


Arguments used with Open 


a into a folder instead of opening a 
ie. 
Add to search list. 


Remove from search list. 


Find "\(very \)*good" "gGi-w" 
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searches for the word “good” preceded by any number of the 
words “very”. The first argument, "very \)*good", is a Regular 
Expression meaning “zero or more occurrences of the strings 
‘very ’, followed by the word ‘good’.” See Section 7 for a more 
complete explanation of how to write Regular Expressions. 


The arguments "gGi-w" are interpreted as follows: 

g - Means that the Find argument "\very 
\)*bad" is a Regular Expression. If we 
forgot to include the g argument, and the 
Regular Expression box in the Find 
dialog were not checked, QUED/M 
would search for a literal occurrence of 
*“\(very \)*bad”, which is not something 
likely to be found in many text files. With 
the g argument, QUED/M knows to 
interpret the \ and \) as grouping symbols 
and the asterisk as a “zero or more 


occurrence” symbol. 

G Global: tells QUED/M to search for the 
expression in every open window, not 
just the top one. 

i Is the ignore case indicator. This will 


ensure that very good things will be 
found, whether they are “Good”, “very 
good”, “VeRy very GOOD”, or “very 
VERY very VERY good.” 


“WwW Means that the whole word toggle is to be 
off. We cannot have the whole word 
toggled on here as we want to indicate the 
possibility of a sequence of characters 
including a space. A space cannot count 
as part of a word. 


When a QUED/M option is turned on or off by the use of a one 


or two letter argument in a macro, that option is turned on or off - 


only for that line of the macro. After the command line has been 
executed, the option returns to its previous state. In other words, 
the option arguments do not actually change the option settings 
in the dialogs or menus, they just temporarily override them, 
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Default Arguments 
If an argument is omitted, QUED/M uses the current setting of 
the options in the appropriate dialog or menu. Be sure to include 
arguments explicitly whenever an incorrect option setting might 
produce an incorrect result. 


Toggle options which appear in the menus can be turned on and 
off directly from within macros. The macro commands are just 
the name of the option, possibly followed by "on" or "off", as in 


Global Search "on" 
Line Numbers “off" 
Gremlin Alert 


Changing an option this way will affect all subsequent actions, 
unless the option is turned off, or is temporarily overridden by a 
macro argument. When an option name is given as a command 
without an "on" or "off" argument, QUED/M will toggle the 
item, turning it on if it was off, or off if it was on. 


Only options which appear in italics in one of QUED/M’s menus 
can be toggled in this way. Options available in dialog boxes are 
usually controllable via macro arguments, as described earlier in 
this section. 


9.5 Executing Text as Macros 


To allow for quick testing of a macro, QUED/M can immediately 
execute selected text which appears in any editing window as if 
it were a macro, For example, if you type: 


New “Baby File” 


into any file window, select-it with the mouse, and choose 
Execute Macro from the Macros menu, QUED/M will treat the 
selected text as if it were a previously saved macro. When 
executed, this example would open up a new file editing 
window named “Baby File”. This text is not stored as a macro, 
it must be copied into a macro editing window and saved to be 
made available from the Macros menu. 

When you choose Execute Macro, QUED/M moves the top 
window (the one in which you selected the macro) to the back, 
behind all other windows. Any editing commands in the macro 
will take effect on whatever window is now on top and 
activated. This generally means that, when executing text as a 
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nacro using Execute Macro command, the macro’s actions will 
ake effect on the window just under the one containing the 
nacro text being executed, unless the macro itself opens a new 
ile or changes the active window. 


ior example, you are editing the file “Hard Disk Dances”, and 
jou want to write a macro to change the file, but you do not 
vant to save this macro. Instead of opening a macro editing 
vindow, you can open a new, empty text file by choosing 
Jew... from the File menu, and giving it a name like “Dance 
Macro”. The empty “Dance Macro” is now the top window, 
vith the “Hard Disk Dances” window immediately beneath it, 
ind possible other windows beneath “Hard Disk Dances”. Now 
ype the macro into the top window, 


Find “dance” 
Key waltz 


3elect the macro text, by dragging and choose Execute Macro 
rom the Macros menu. QUED/M will then 


¢ Move the “Dance Macro” window behind all other 
open windows. 

¢ Search for the word “dance” in the “Hard Disk 
Dances” window, which is now on top. 

¢ Replace the word dance (assuming it is found) with 
the word “waltz”. 


You can have QUED/M repeat the macro by clicking into the 
‘Dance Window” to bring it back to the front, selecting the 
nacro text if it is not still selected, and choosing Execute Macro 
again. This is often an easy way to debug macros. Rather than 
naking small changes in a macro by editing, saving, and 
>xecuting it, just keep modifying the macro in an open window, 
selecting it one line at a time, and choosing Execute Macro until 
QUED/M performs the tasks as you intended. 


Execute Macro works on the inactive window which the 


Macintosh thinks is behind the top window. The Macintosh 
considers windows to be stacked in the order they have recently 
been activated. The current, active window is on top, the 
window used just before this one is right behind it, and so forth. 
When editing macros, it is often convenient to have two 
windows displayed side by side on the screen, one on which the 
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macro is being edited, the other containing the text is used to test 
the macro. ' 


When an executing macro opens a new window or dialog, any 
typing (from the “Key ” command) or other changes will take 
place within that new window or dialog. The macro will 
continue to be executed from its own window, regardless of 
which window is currently on top. 


It is perfectly acceptable, and often convenient, to write and 
execute a macro from a clipboard window. Be sure not to use 
that clipboard in the macro for cutting or copying, however, or 
the macro itself will be clobbered. 


9.6 Automatically Executed Macros 


The following specially reserved macro names should only be 
used for macros that you want to execute automatically under the 
following specified circumstances. 


COMMAND 
COMMANDOPTION 
‘OPTION will each be executed whenever you 
double-click into a document or clipboard 
window while holding down the 
Command, Command and Option, or 
Option keys, respectively. They are 
useful for such macros as those which 
- automatically paste the selection into the 
Find or Change dialog box. 


INITOPEN will execute automatically when any file 
is opened: 


INITINIT will execute automatically when QUED/M 
is first run. In order for it to do so 
however, it must bein a macro file named 
“QUED/M Macros” which must be 
present in the same folder as QUED/M. 


INITREVERT will be executed every time you choose 
Revert from the File menu to change a file 
to the last version saved. 
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INITNEW will be executed automatically every time 


a new file is opened. 
SWITCHIN will be executed every time you switch 
. into QUED/M with the Switcher. This 
(and the SWITCHOUT macro described 
below) may be useful to you when using 
QUED/M with a program development 
system which has its own integrated 
editor. Each time you switch into 
QUED/M you would have the 
SWITCHIN macro do a “Command 
Option Revert” to the saved version of 
your file. Thus if you had modified your 
files and saved the changes in the 
development system, the modified 
versions would be present when you 
switched back to QUED/M. . . 
SWITCHOUT will be executed every time you switch 
out of QUED/M in the Switcher. You can 
use this macro to have QUED/M save the 
file you are working on automatically 
before the switch to another program, so 
the other program will have the latest 
version available to be read in. 


There is a built-in COMMANDOPTION macro which exchanges 
the selection with Clipboard 9. If you press the Option and 
Command keys while double-clicking on a word, the word will 
be selected and exchanged with whatever was in Clipboard 9. 
Your own COMMANDOPTION macro can be written to 
override this built-in macro. If you want to disable it, create a 
COMMANDOPTION macro which has no instructions. 


Find Selection 
QUED/M has a COMMAND macro which copies a selection to 


the Search dialog. If you press and hold the Command key - 


while double-clicking on a word (thereby selecting it) it will be 
| copied automatically to the Find dialog. If you want to select and 
copy more than one word to the Search dialog, press and hold 
the Command key, double-click at the beginning of the text but 
do not release the second click until you have dragged the mouse 


JHE O OREO oao 


75 


to the end of the region of text. Releasing the mouse triggers the 
macro and copies the selection into the search dialog. 


9.7 Calling Macros within Macros 


A macro can invoke any other macro that is currently loaded and 
appears in the Macros menu. Invoking one macro from within 
another is like executing any other menu item. Just write the 
name of the macro to be invoked on its own seperate line in the 
calling macro. 


Example 10: Swapping Characters 
If we want a macro to “roll” three characters, that is, one that 
will turn “abe” into “bea”, or “cat” into “atc”. If you typed in the 
first example of this section, that is the “Swap Char” macro, you 
can use that macro to quickly write another one that can “roll” 
three characters. 


Rolling characters can be seen as two successive swaps, where 
“abc” becomes “bac” and then “bca”. If we were to put the 
insertion point immediately before the letter “a” in “abc”, and 
then choose the “swap char” macro, it would swap the “a” and 
“by”, but the insertion point's position would remain to the right 
of the “b”. So, to swap the “b” and the “‘c”, we need to move the 
insertion point back one character before calling “swap char” 
again. QUED/M allows you to move the insertion point back a 
character by typing Command-backspace or Command-delete. 
The whole “roll” macro looks like this: 


swap char 
Key %<backspace> 
swap char 
The easiest way to type the second line of this macro into a 
macro editing window is to choose Record Macro from the 
Macros menu, hold down the Command key while hitting the 
backspace or delete key, and then choose Stop Recording from 


_ the Macros menu. The Command-backspace will appear as a E 


symbol followed by a small rectangle on, the screen, since there 
are no characters to represent backspace. 


Once this macro has been typed into a macro editing window 


and saved, it can be invoked by choosing it from the Macros 
menu. Note that the “swap char” macro must also be present in 
the Macros window for this macro to work, since “roll” attempts 


16 


twice to call “swap char”. Choosing “roll” will now swap the 
first of the three characters with the last. 


Deleting Macros 
To delete a macro which appears on the Macro menu do the 
following: 


¢ Select Edit Macro from the Macros menu. 

* Select or type the name of the macro exactly as it 
appears on the Macros menu. 

¢ Click the “Delete” button. 


Looping Macros 
Macros can also invoke themselves. This creates a loop. If the 
last command in a macro is one which starts the macro over, 
then that macro will be executed over and over, until some error 
or test causes it to stop. If you add the letter “T” as a parameter 
in a Find or Change line of a macro, a looping macro will 
terminate when the search is unsuccessful. 


Example 11: Looping Macro 
Example 3 of this section replaced the next occurrence of 
“Paragon Courseware” with “Paragon Concepts Inc”. If we 
want to change the macro so that it replaces all remaining 
occurrences, we can add a line to the end of the macro which 
causes it to invoke itself again. If you had saved the macro under 
the name “Replace Macro”, and it was currently listed in the 
Macros menu under that name, by adding the line: 


Replace Macro 


to the end of the macro would cause it to repeat itself, over and 
over. The modified Replace Macro would look like this: 


Key %fParagon Courseware 
Key 

Key %¢. 

Key Paragon Concepts Inc. 
Replace Macro 


This macro now performs a “Replace all” function. It will keep 
replacing the string “Paragon Courseware” with the string 
“Paragon Concepts Inc.” until there are no more to replace. 
QUED/M will then stop the macro, and ask if you want to 
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continue (which would be pointless, since it would just stop 
again) or exit the macro. 


Although it is more efficient in most cases to use Change with 
the “a” argument (that is, do a Change All) rather than use a 
looping macro, as was done above, there are situations where 
you have to use a looping macro for replacements. QUED/M 
uses a very efficient procedure for doing a Change All, but 
because of this, it does not give you control over the order in 
which the replacements will occur. If the result of the intended 
replacements depends upon their being completed in a specific 
sequence, use a looping macro to perform the changes. 


Example 12: Indent Macro 
This macro will indent all the beginnings of the wrapped lines in 
a file. It will not indent the beginnings of explicit lines, that is, 
new lines or paragraphs which are preceded by a Return. This is 
done by finding where QUED/M wrapped a line and hitting the 
Return and Tab key there. 


AutoIndent “off" 

Find ":*:<[*\r]" "-A-wg" 
Key 

Key <tab> 

Indent 


Do not forget the space immediately following each “Key ” 
command. This macro is given the name "Indent". 


Example 12 Explained 
¢ Autolndent is turned off. If AutoIndent were not 
explicitly turned off by the macro, whenever a line is 
split up by typing a Retum, an extra, unintended tab 
may be added by QUED/M to match the indentation of 
the previous paragraph. 
e Find is used to go to the next wrapped line. 


ie _ matches the beginning of any line, wrapped 
or explicit. : 
:<[4\r] means the previous character should not be a 


Return. This is what makes the match apply 
to wrapped lines only. QUED/M is bein 
told to match the beginning of lines ( "A 
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only when the preceding character ( :< ) is 
not ( [4] ) a Return (\r ). 


-A turns off Auto Wrap, to make sure the 
searching stops at the end of the file, rather 
than wrapping around and continuing from 


the beginning. 

-W turns off Whole Word searching, since we 
are searching for special characters, not for 
words. 

g turns on Regular Expression searching. 


If you were to do a "Change All” in the above Indent macro, you 
would not get the same result. QUED/M does not reevaluate 
where word wraps should occur while doing a Change All, so 
the tabs would end up in the wrong locations. Try it! To type in 
the Tab character into the Find or Change dialog, type Shift-Tab. 


Example 13: Check Caps Macro 
The “Check Caps” macro looks for lowercase characters which 
follow the ends of sentences. 


Find "[{.2?!])-\(:bI\r\)+:1" “gA-wT" 
Upcase 
Check Caps 


It is supposed to check for proper capitalization. It is not 
foolproof since if there is a period following an initial or an 
abbreviation it will treat it as the end of a sentence and capitalize 
the following letter. 


Here is a modified version of the same macro which will not 
regard a period after a capital letter as the end of a sentence: 


Find ":<[*A-2][.2?!])-\(:bI\r\)+:1" “gA-wt" 
Upcase 
Check Caps 


Unfortunately it is not foolproof since not all characters ending 
in capital letters are initials. Furthermore it does not make 
exceptions for abbreviations (such as i.e.) in lowercase. It is 
difficult to make this macro foolproof. 
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Example 13 Explained 
3<[4A-Z] 1 This states that the previous character is 
not to be a capital letter. 
[!?.] This represents any character in the set 
“12.” which usually represents the end of 
a sentence. 


)- Allows the end of a sentence to be 
bracketed. The minus “-” means “zero or 
one occurrence of”. 

\(:b]\r\)+ Represents any “blank” (:b) or a Return 
(\r). The plus “+” means repeated one or 
more times. This part is bracketed so that 
the “or” only connects the blank and 
return characters and the + outside the 
brackets also applies to both the blank 
and the return character in any number of 
combinations. 


+ | This represents a lowercase characier. 


The net result is that any lowercase character at the beginning of 
a sentence is selected and “Upcase” converts it to a capital. The 
last line of the macro calls the same macro once more. This 
continues until the Find is unsuccessful when the “T”’ in the last 
quotes makes sure the macro terminates. 


You should note that this macro will not check the beginning of 
text. This could be corrected for by using the “:s” metacharacter, 
but seems hardly necessary in practice. 


9.8 Advanced Examples 


Using Arguments 
There are other ways of writing macros which give you better 
control of their execution. Example 3, Replace Macro, can be 
written as follows 


Change "Paragon Courseware” to "Paragon Concepts" "a" 


The word “to” in the macro above is optional. All you need to 
separate arguments is one space. This is therefore equivalent to 
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Change “Paragon Courseware" "Paragon Concepts" "a" 


The last argument "a" means "Change All", so that the Replace 
will be performed throughout the entire file. 


Using Toggles 
Menu toggle options can be turned on or off inside macros. To 
ensure that Auto Wrap (from the Search menu) is turned on 
while a macro is executing, include this line 


Auto Wrap "on" 
To be certain it is turned off, use 
Auto Wrap "off" 
Another method is to add a -A to the last argument. 


Change “Paragon Courseware" "Paragon Concepts w Ag" 
This last method only temporarily ensures that Auto Wrap is 
turned off. It does not change that state of the option, so if Auto 
Wrap was on before this macro command was executed, it will 
be turned back on after execution of this line. 


Using Undo and Redo 

Each time Undo is invoked or selected, it reverses the action of 
one macro execution. Undone actions, including macro 
executions, can be redone by choosing Redo from the Edit 
menu. As soon as any further text change is performed, the 
possibility to Redo is lost. Redoing is only possible after an 
Undo and before more text is typed at the keyboard, or until a 
macro is executed, or any other new change is made to the file. 


Search Argument Interpretation 
When doing Regular Expression searching, QUED/M needs to 
interpret the arguments, SO that special metacharacter matching 
and replacement is done appropriately. When Regular 
Expression searching is turned off, no interpretation of the 
arguments is done. For example, 


Find "Dept. of Computer Science$" 


will literally search for “Dept. of Computer Science$” using the 
literal meaning of the $ character. If the Regular Expression is 
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hag on, the $ character will be interpreted as the end of the 
ne. 


Within a macro there is another way to have QUED/M interpret 


_ expressions. This is accomplished by using single quotes with 


expressions instead of double quotes. Consider these two macro 
commands: 


Change "Dept. of Computer Science" to "\CC" "g" 


Change "Dept. of Computer Science” to *\CC" “=g* 
These two macro commands perform exactly the same action, 
they replace the next occurrence of “Dept. of Computer Science” 
with the contents of the current clipboard (represented by the 
‘\CC”). The first command has Regular Expressions turned on 
by the "g" option; the second has it turned off by "-g", but 
because the ‘ACC” is in single quotes, QUED/M knows that it 
has to interpret the meaning of that argument rather than take it 
as a literal replacement. 


If we fail to indicate that the second argument is to be interpreted 
and typed it in as 

Change "Dept. of Computer Science" to "\CC" “-g" 
then QUED/M will look for the next occurrence of “Dept. of 
— Science” and replace it with the three characters 


Only the following metacharacters are interpreted when inside an 
expression surrounded by single quotes: 


\CC Contents of the current clipboard 

\CO Contents of clipboard 0 

\c9 Contents of clipboard 9 

& Current ahiction (usually the most 
recently found text) 

\l First expression surrounded by \( and \) 

\9 Ninth expression surrounded by \( and \) 
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Regular Expression Interpretation versus 

| Single Quote Interpretation 

| There is an important difference between interpretation of 
arguments when they are in single quotes and when they are in 
Regular Expressions. In single quotes, the interpretation is done 
| before the Search command is executed. In Regular 
_ Expressions, it is done after the Search command is executed. 
So the replacement of metacharacters in single quotes is based 
on whatever was found or selected before the current execution 
of the macro command. The commands 


Find "\(happy\) \(camper\)" "g" 
Change “money talks" ‘\2 bs es > ig 


will first search for “Happy Camper”, and then replace an 
occurrence of "Money Talks" with "Camper Happy". Notice 
how the ‘2 \1' refers to the Find expression, and not to the 
Change expression. This is because the bracketed expressions 
occured in the Find Expression. 


If the Regular Expression option is tured on and single quotes 
are used, the interpretation of the arguments is done twice. The 
single quoted arguments are interpreted first, then the search is 


performed, and finally the substitution of any remaining Regular 
Expression metacharacters is done. 


Find "\(happy\) \(camper\)" "g" 
Change ‘money \1' "XX & XX" "g" 


This macro will search for “Happy Camper”, and then “Money 
Happy”. If it finds an occurrence of “Money Happy”, it will 
replace it with “XX money happy XX”. The arguments of the 
Change command are: 


‘money \1' 
Because this is in single quotes, the \l is replaced before 
searching, with the first part of the previous expression found. 
In this macro, it is the “Happy” of “Happy Camper”. 


"XX & XX" 


This is enclosed in double quotes so the metacharacter "&" is 
replaced with the selected text after the search is done. In this 
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case, the selected text should be “Money Happy”, so the entire 
replacement text is. 
“XX money happy XX”. "g" 


The "g" argument turns on the Regular Expression option. This 


_ is necessary for the metacharacter “&” to be replaced with the — 


search string. Otherwise the replacement string might be 
interpreted literally, resulting in “Happy Camper” being replaced 
with “XX & XX” instead of with “XX money happy XX”. 


Summary of Metacharacter Substitution 
Expressions inside quotes as arguments of the Find or Change 
macro commands are taken literally if they are inside double 
quotes and the Regular Expression is not turned on. If an 
argument is in single quotes, substitution is made before the find 
is made, which means that expressions like \1 refer to the 
previous expression found. If the Regular Expression option is 
turned on, substitution of metacharacters inside double quotes 
takes place after the find is made. 


Single quoted expressions are taken with substitution of the 
clipboard (like \C2), item (like \3), and current selection (&) 
metacharacters before the execution of the macro. With the 
Regular Expression option tumed on, single quoted expressions 
in a change argument are substituted for twice, once before the 
find and once after the find but before the change. 


9.9 Anatomy of a Macro 


Example 14: Extract Phone List Macro 
Among other things, this macro illustrates the method of text 
selection and copying from within a macro. We begin with the 
text of the macro and follow with a line-by-line explanation. 


1 Find ":d:d:d)- -\-- -:d:d:d -\-- -:d:d:d:d\([*0-9]l:e1$\)" *-Awgt" 
2 Key # This is Cmd backspace. 

3 Find “$" "-A-wtgE* Find End of line with Phone # 

4 Set Marker “Phone Number" 
5 Find “*:** "-A-wtgrt" 

6 eJump “Phone Number“ 


Find beginning of line with Ph# 
Jump selecting whole line with # 


7 Copy "8" Copy selected Phi into Clipboard 8 
8 Find “\r\r" “-A-wtgrE* Reverse find blank line 

9 Set Marker “Guys Name" Mark name beginning 

10 Find “$* "-A-wtgT" Find end of line with name 

11 eJump “Guys Name" Jump selecting name 

12 @Copy “9" Append name to Clipboard 9 
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| éJump “Guys Name" Delete name marker 
} @Copy “9"' \c8 ' Append Clp8 to Clp9 
} Jump “Phone Number" Check for any other Ph# 
) Jump “Phone Number" Delete phone marker 
| Extract Phone List Repeat until not found 


he lines here are numbered for ease of reference. The macro 
‘ill not work if the line numbers are present. This macro 
<tracts all names with their phone numbers from the top file 
eferred to as “the source file”) and copies them into Clipboard 
. It assumes that the top file has a list of names, addresses and 
hone numbers in the following (approximate) format: 


Thomas A. Smith, Vice President of Marketing 

50. A St. West 

High Town CA 91111 

Home Phone (619) 111-2222 Call after 6:00 pm. 
Office Ph (619) 111 - 3333 extension 76 

Any notes can follow here, on any number of lines. 
Next name begins after at least one blank line. 


Example 14; Explained One Line At A Time 
his macro finds a sequence of digits that should be the phone 
umber, using Regular Expression examples. 


ine 1 

he Regular Expression means the following: three digits 
slowed by zero or one occurrence of a right parenthesis, 
dllowed by zero or one space, followed by none or one minus 
gn, followed by zero or one space, followed by three digits, 
slowed by zero or one space, followed by zero or one minus 
gn, then zero or one space, then four digits, then anything but 
digit. The last part includes the possibility that the end of text 
ran end of line follows the end of the number. 


‘ou will notice that the definition of the phone number will 
over a lot of different ways of writing the phone number. It 
‘quires, however, that the phone number include the area code. 
in your case you have included local phone numbers without 
l€ area Code, you could cover both Possibilities by bracketing in 
\¢ area Code part and placing a minus sign (meaning zero or one 
ecurrence of..) following the bracket. The following would 
en be the expression inside the first quotes of line 1: 


(:did:d)-\)- -\-- -:d:da:a ~\r- -:did:d:d\([*0-9] lz:el1$\) 
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Line 2 


Deselects the found phone number placing the I-beam at its 
beginning. 


Line 3 

Finds the end of the line containing the phone number. The line 
end is not necessarily the end of the number; some other piece of 
information could follow the number, 


Lines 4-14 
Can easily be understood from the comments. 


Line 15 

Brings the I-beam back to the end of the line with the phone 
number already copied. From that point on, the process is 
repeated. This procedure ensures that if there were two or more 
phone numbers on separate lines for one person, they will! both 
be picked up. In such a case the name of the person will be 
repeated. 


The address can have any other reasonable form. The only 
assumptions are that 


¢ There are no blank lines within each record 

* Blank lines are used to separate the records 

* First line contains the first name then last name, in that 

order. 

Note that if the first line also contains things like company name, 
Position, etc., then all these will be copied into the phone list. It 
would be relatively easy to modify the macro to extract only the 
first two names (plus, possibly, a middle initial) if that is what is 
needed. “Extract Phone List” macro is supplied with QUED/M . 


Control Macro 
If you want to have the macro open a new file and paste the 
phone list into it, you will have to write another macro (the 
“control”), which calls this one. The following will do this: 


Copy “gr we 
Open "Address file" 
Extract Phone List 


This clears clipboard 9 
This is the source file 
Places phone #s in Clip 9 


New "Phone List" Open new file 

Paste "9" Paste the phone list 

Jump "1" Start at beginning of file 
Last-First Swap Get Last names first (A Macro) 
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Select All 
Sort Lines Alphabetize 
Change "\rt" "" "A-wgtT" Remove all blank lines Macro;. 


The Copy "9" "" is used to clear Clipboard 9. This is needed 
since Extract Phone List keeps appending to the clipboard. This 
macro no longer assumes that the source file is open. It will 
ypen the source file, provided it is in the current directory and is 
named “Address File”. : 


Note that this macro calls two other macros. The First-Last 
Swap Macro to swap the first and last names. To alphabetize a 
phone list by the last name, we need to have the last name first. 


The preceding is an introduction to QUED/M Macros using 
examples. You may need to write more complicated macros to 
perform special functions. A macro can do anything which you 
can do directly. You may, however, have to use your ingenuity 
and creativity to achieve the desired result in a macro. 


9.10 Macro Tips 


There is no direct way to move or click the mouse from within a 
macro. If you want to move the insertion point you have to use 
the keyboard equivalents to do it. Likewise, to select text you 
must use keyboard equivalents or use the Find menu item. 


Key Selection 

To select text using the keys, press and hold the shift key while 
moving the I-beam with the keys. Select one character with 
Shift-Command-Space, (or Shift-Command right arrow) or a 
whole line (or paragraph, if QUED/M is wrapping lines) with 
Shift-Command and Return. This allows you to select text from 
within macros using key strokes. See Section 10 for a complete 
listing of keyboard commands. 


' Jump Selection 
Selecting text from within a macro can be done in conjunction 
with a Find as follows: - , 


¢ Set a temporary marker at one end of the text to be 
selected. 
¢ Find the other end of the text. 
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¢ Use the Jump marker command with the shift key 
held down to jump over and select the text. 


Here is a sample macro that uses the Jump command to select 
text. This macro cuts all of the text from the next occurrence of 
the words “Stock Market” to the end of the line that “Stock 
Market” is on. 


Find “Stock Market" 
Set Marker 

Key 

Key # 

@Jump "Stock" 

Cut 


The commands “Find "Stock Market”, “Set Marker”, “Key ” 
search for the words “Stock Market” and place a marker called 
“Stock” there. The “Key” macro command is equivalent to 
clicking the default button, “Set” in the Set Marker... dialog. 
“Key 9” is equivalent to typing Command-Return, it moves the 
insertion point to the start of the next line. “@Jump "Stock"” 
jumps back to where the marker was placed. The shift key is 
held down , as indicated by the @ symbol , and the text jumped 
over is selected. Finally, the text is cut to the current clipboard. 
Jump can also take two marker names as arguments. 


@Jump “pointl" “point2" 
will select the text between markers “point1” and “point2”. 


Line numbers can be used separately or together as arguments 
with Jump. The macro 
@Jump "5" "8" 


will select all text between the beginnings of lines 5 and 8 that is 
everything on lines 5, 6, and 7, but not on line 8. 


Macros cannot use mouse clicks to select dialog buttons, 
keyboard equivalents or arguments must be used instead. 


Clipboards and Macros 
The following expressions are useful in copying to and pasting 
from the ten clipboards. 
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\CC Refers to the contents of current 
clipboard. This can be used in Find 
and Change expressions, and as an 
argument for the Open and New 
commands (as in “Open \CC"”, 
which will open a file whose name is 
in the current clipboard). 


\CO Represents the contents of clipboard 
0. To address the other clipboards, 
use \C1 through \C9. 


The following are some examples of clipboard references in 
macros. 


Copy "3" '\c5' Copies Clipboard 5 into Clipboard 3 
@Copy "3" '\C5' Adds Clipboard 5 to Clipboard 3. 
Copy "3" Copies the selected text (or the last deleted text if 


none selected) into clipboard #3. 

Copy "" "1987" Copies "1987" to current clipboard. 
@Copy "4" "hi" Adds “hi” to clipboard 4. 
Paste "5" Pastes clipboard 5 into text. 
@Paste "6" Swaps Clipboard 6 with selected text. 

Clipboards Updating , 
Changes made by a macro in a clipboard will not become visible 
until another window event has occurred. Simply closing and 
reopening the clipboard will update it. Be sure to use the 
commands “Clipboard “off” and “Clipboard "on"” to close and 
open the clipboard. “Close” will not work! 
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10 MACRO ARGUMENTS 


Change All. 
Auto Wrap. 
Reverse Search. 


Copy text into find/change dialog, but do 
not do the search. 


Put I-beam at end (or beginning if 
searching backwards) of text if pattern 
not found. Count this as a successful 
search if selection did not start there. This 
automatically turns off Multifile, Auto 
Wrap, and Global Search. 

Turn on Regular Expression. 

Turn on Regular Expression. 

Global Search. 

Ignore Case. 


Change All in selected lines of top text 
window (see “s”). 


Multifile. 

Multifile. 

Select the last change when finished 
making changes (in conjunction with a, s, 
or 1) 


Reverse search. 


Change All in selected region of top text 
window (see “I’”). 


Terse. Will not display dialog if pattern 
was not found. 
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1 Terminate current macro if unsuccessful 
search. 
v Verbose. Will display a dialog with the 


number of substitutions made on a 
Change All. Normally this dialog is not 


displayed from a macro, 
w Whole Word search. 
W Auto Wrap. 
Xx Used only in Find, to search through 


unopened files and save file paths to files 
(containing the found expression) in 
current clipboard. 


10.1 Macro Argument Examples 


The following is a list of some useful examples of macro 
commands using various arguments. The Change command can 
take either no arguments or two or three arguments. The first 
two arguments can be any Regular Expressions inside double or 
single quotes. The third argument is optional but if present must 
be inside double quotes. 


Paste "3" "test" Copies selection into clipboard 3, and then pastes “test” 
into selection. 
Change "of" "on" "pb" 
Finds previous occurrences of "of" and changes it to 
“on" ("b" means "backward" search). See list above for 
other options to put in third argument. 
Closes clipboard window. 
. Tums on clipboard, brings it to front 
Copies the word Test into clipboard 3. 
Copies the selected region (if none currently selected, 
the expression last selected or found) into clipboard 2 
and adds a carriage return (\r) to the end of clipboard 2. 
Note the single quotes in the second argument. 
Copies selected text into clipboard 3 
Copies into clipboard 3, then cuts text. 
Finds any digit at the beginning of a line (g means 
Regular Expression on). See above listing for what to 
put in the second argument. 
Selects text between marker "b" and beginning of line 
100. 


Clipboard “off" 
Clipboard “on" 
Copy "3" 'Test' 
Copy "2" ‘e\r' 


Copy " 3 “ 
Cut "3" 
Find ":*:q" "g" 


Jump "100" "be" 


@Jump "a" "b" Selects text between markers "a" and "b". 
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*Jump "a" "END" 
New "Notes File" 
Open "Notes" "ic" 


Selects from marker "a" to end of text. 

Creates a new file window with the name "Notes File." 
Changes into directory called “Notes” which must be 
in the current directory, that is. one of those showing 
in the file dialog window. 

Open “Letter to Jo"Opens the file "Letter to Jo" from the (current) directory 
showing in the file dialog window. 

Adds file "To do” to search list. 

Removes file "Done" from search list. 

Pastes "Bob" into selection. 

Pastes “Bob" followed by carriage return (\r) into 
selection. Note the single quotes. 

Pastes clipboard 3 into selection. 

Renames current document to have name “new", 
without saving document. 

Save As "newname" Saves current document with name “newname”. 

Set Marker "a" Puts a marker at selection start called “‘a”. 

Set Marker "a" "b" Same as above, but also puts a marker called "b" at 
selection end. 


Open "To do" "A" 
Open "Done" "RB" 
Paste "" "Bob" 

Paste "" 'Bob\r' 


Paste "3" 
Save As "new" "" 


10.2 Hints for Writing Macros 


The current implementation of macros does not include a full 
macro language. Many things which at first appear impossible 
can nevertheless be done. Here are some hints for creating 
advanced macros. 


File Name 
Here is a macro which copies, to the current clipboard, the name 
of the file being edited in the active window, 


Save As 
Copy 
¢ * . 


This macro relies on the fact that after a “Save As” the file dialog 
has the current file name selected in its window. Thus a “Copy” 
will place the name in the current clipboard. The final Shift- 
Command-Period cancels and closes the dialog. 


Remove Duplicate Words 

Suppose you have a list of words or phrases, one on each line, 
and you wish to delete all duplicate words or phrases. We 
assume here that you have first sorted them, so any duplicates 
will follow each other. Here is a one line macro which will do it. 


Change "\(*.*\r\)\1+" to "\1" "“-wAagT" 


92 


11 MENU and COMMAND LISTINGS 
(This section is for reference purposes.) 


Window Controls 
The same window controls are available in QUED/M as are in 
the Finder at the desktop. There are however several additions 
and enhancements. The following are the additional controls: 


* You can zoom the current window in the standard 
way by clicking once in the zoom box, or by double- 
clicking the control bar of the window. The latter 
method is the only one available to you when the 
zoom box is not visible (moved off the screen) or 
when you are in a nondocument window such as the 
Macro window or the Transfer editing window. 

¢ The scrolling direction of can be reversed by holding 
the Option key down. 

¢ You can control all windows behind the current 
window (without swapping to them) by holding the 
Command key pressed while using the mouse in the 
normal way. 


QUED/M commands are listed in the order they appear in the 
menus. Following the description of each command are notes on 
how the command can be used from within a macro. This is 
followed by a list of keyboard shortcuts related to the command. 


Modifier Key Notation 
The symbol % preceding a character means that the item is 
invoked as a Command key equivalent. For example, %N 
‘indicates that the 9€ is held down while the N key is pressed and 
released. The % key is a modifier key and is located near the 
bottom left corner of the keyboard. Similarly, the symbol @ is 
used to represent the Option key and the symbol @ is used for 
the Shift key. On some keyboards, the command key is marked 
with two symbols, 9% and C3. The @ symbol, as used in 


QUED/M, refers to the key labeled Option, not to the Command 
key. 


Option for All Windows 
If the parenthesized phrase (Option for all windows) appears at 
the end of a menu item’s description in this section, it means that 
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pressing and holding the Option key while choosing this item 
will make it affect all open windows, not just the active window. 
This modifier works only when the item is chosen from the 
menu with the mouse, not when typing the keyboard equivalent, 


Universal Abort #. 
The abort command feature allows you to stop QUED/M during 


an operation by typing 9%. This is done by holding down the 
command key and pressing the period key. You must continue 
holding down these keys until QUED/M gives the message 
“Action aborted by user.” During long operations (such as a 
complicated change in a very long file) the % and . keys may 
have to be held down for many seconds. If the phrase 
(Universal Abort) appears at the end of a menu item’s 
description in this section, aborting the execution of that item is 
possible. 


11.1 @ Apple Menu 


This menu includes the About QUED/M item and desk 
accessories, as usual. Choose About QUED/M to see the version 
number of QUED/M which you are using. 


Macro Use 
You can invoke any item from this menu in a macro. You can 
use the Alarm Clock and Calculator desk accessories by simply 
including their name as a macro command.The following macro 
will copy the date and time from the clock to Clipboard 0. 


Alarm Clock 
Copy "0" 
Close 


If you are doing a calculation this macro will add the number in 
Clipboard 0 to the one in Clipboard 1 and put the result in 
Clipboard 2: 


Calculator Bring Calculator to front. 


Key C Clear the Calculator. 

Paste "0" Paste the first number into the Calculator. 
Key + Type the + key. 

Paste "1" Enter the second number. 

Key = Get the answer. 

Copy "2" Copy the answer into Clipboard 2. 
Close Close the calculator. 
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11.2 File Menu 

New 
Opens a new file window for editing. After choosing New, 
QUED/M will put up a file dialog box asking for the name of the 
new file. Use the file dialog to move to the disk and folder in 
which you want the new file to be saved, type in a name for the 
new file, and click the Name button. 


New is also available in the “Other” submenu of the Open file 
dialog. 


Macro Use 
The macro command New takes one argument, the name of the 
file to open. 


New "Notes File” 


will open a new file editing window and give it the name “Notes 
File”. 


If there is a macro called INITNEW, it will be executed 
automatically whenever a new file is opened. You can suppress 
the execution of the INITNEW macro by pressing and holding 
the Command key when choosing New from the file menu. 


Open 
Puts Paragon’s unique File Dialog on the screen, from which 
you can select the files you wish to open. If the file dialog is 
already on the screen but is hidden by other windows, choosing 
Open will bring it to the front. 


To open a text file for editing, either click on its name in the 
Open dialog to select it and click the Open button, or double- 
click the file name. The Open... item in the File menu brings up 
the Open dialog, the item does not itself open files. Files which 
are currently open are marked with a check. Attempting to open 
an already open file will bring its window to the front. 


Several files can be opened together if their names are listed 
contiguously in the dialog, dragging down through the file 
names will select them. To open files in folders other than the 
one displayed in the dialog, use these controls: 
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¢ The menu with the current folder’s name allows you 
to choose any of the folders that are higher in 
hierarchy than the current folder in the HFS hierarchy. 

¢ Clicking on the word “Drive” takes you to the folder 
immediately above the current one, unless the current 
one is the volume’s main directory. This is equivalent 
va pressing the Up arrow while holding the Command 

ey. 

¢ The Drive menu allows you to choose any of the 
currently available disk drives. Pressing the Tab key 
will cycle the dialog through all available drives. 

¢ To open a folder that is, to see the contents of a folder 
in the dialog window either select the folder’s name 
and click Open, or double-click the folder’s name. 

¢ Folder and file names can also be selected with the up 
and down arrow keys. Selected files or folders can be 
opened by pressing Return, folders by pressing the 
Command key and then the Down arrow. 


QUED/M'’s file dialog stays around behind any open text file 
window. Clicking its close box will make it disappear. QUED/M 
has an alternative Open dialog, available by clicking the Open 
dialog’s zoom box or by double-clicking its title bar. The 
alternative dialog has a layout similar to other programs’ file 
dialogs, and like the other programs’ dialogs, it will disappear 
after opening a file. 


QUED/M treats its Open dialog window like a text file window. 
Many of the options available in the Format window also apply 
to the File dialog, including line numbers (which will show you 
the number of files and folders in the current folder), invisible 
character display, and ASCII hex displays, The Font menu can 
be used to change the font and size of the file listings, and the 
Edit menu allows copying of file and directory names for pasting 
into a document. Using the Find feature allows searching for file 
and folder names in the current folder. 


The Other menu in the Open dialog includes the following 
options. 


¢ Open a new file, same as choosing New... from the 
File menu. 

¢ Text only filter. With this option checked, the dialog 
will only list text files and folder names, not other 
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applications or their non-text documents. This option 
is automatically checked unless you have just 
unchecked it. 

¢ Add to search list. 

¢ Remove from search list. 


The last two items appear only if one or more file names are 
selected. 


@Open 

You can open a second copy of an already open file by pressing 
and holding the Shift key while clicking the Open button (or 
while double-clicking the file name). A window opened this way 
is “Read only”, changes to the file can be made only in the 


window of the first copy opened. 
Macro Use 
Open "Max" 


will open a file “Max” which should be in the current folder, the 
folder showing in the Open dialog, (if that is visible). The line 


Open "Test Folder:Max" 


will open the file “Max” inside the folder “Test Folder”. “Test 
Folder” should be on the current disk and inside of the current 
folder. The command 


Open "My Disk:Test Folder:Max" 


will open the file “Max” in the folder “Test Folder” on the disk 
“My Disk”. This is necessary if the disk is not the one showing 
in the file dialog. 


Character Limit On Path Name . 
There is a limit of 255 characters for the path name in any macro 
argument and also in the Transfer menu. 


Change Directory ; 
You can change the current folder or disk from a macro by using 
"C" as a second argument. 


Open "“Subdir" "Cc" 
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will open the folder Subdir which is inside the current folder. 
The macro co : 
j 


Open “ 3 3* “cr 


changes the current folder to its “parent”, that is the folder just 
above the current one in the HFS hierarchy. 


Search list 
The macro command 


@ Open "Old One" "A" 


will add the file “Old One” to the file search list. Using "R" as 
the second argument would remove the file “Old One” from the 
search list. The Command key 


%\ 
toggles “Text only” check box in File dialog Other menu. 


Open Selection 

This item is only highlighted when text is selected. Selecting a 
list of names in a text file and choosing Open Selection will open 
the files. Any file not in the current folder must have its full path 
name specified. Each file name (with path if necessary) must be 
on a separate line. 


QUED/M comes with a macro for creating a list of full path 
names. To get a list of the full path names of certain files, add 
them to the Search list (using the Add item in the Open dialog’s 
Other menu) and execute the List Search Files macro. Paste the 
list into your document from the current clipboard. 


File and folder names can easily be copied from the file dialog 
and pasted into a text file. Because file names copied from the 
File dialog have an invisible return character after them, they 
should not be pasted directly into the Name dialog. A file name 
with an invisible return character can cause problems when you 
try to open the file later. 
Macro Use 

Open Selection accepts no arguments when used as a macro 
command. 
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Close 

'f changes have been made to a file, QUED/M asks if the 
shanges should be saved. (Option for all windows) (Universal 
ibort.) 


lose does not take any arguments in a macro. If you want to 
slose a particular file from within a macro and you have more 
han one file open, first open the file to be closed (this brings its 
window to the front.) 


Open "ThatFile" 
Close 


Save 
QUED/M takes extra precautions to prevent files from being 
destroyed in case the Macintosh is unable to complete the save 
procedure. This could happen if there is not enough space on the 
disk. 


After choosing Save from the file menu, QUED/M renames the 
old version saved on disk by adding “.bak” to its name. 
QUED/M then saves the current, changed version, and if that 
succeeds, deletes the previous, “.bak” file. If the disk is full or 
the Macintosh dies during the save, the “.bak” version is still 
available. (Checking “Keep backups” in the Options dialog will 
stop QUED/M from deleting the old “.bak” version of the file.) 


&Save 
Saves all open files which have been modified. 


@&Save 
Saves all open files, whether modified or not. 


QUED/M saves the file with the date and time of the last typing 
or editing, not with the time of the save. If you finish reading 
and save a file at noon but had finished typing at 11:30 a.m., the 
time on the file will be 11:30 a.m. Even if during reading the 
font or the line width were changed, the time on the saved file 
would still be the time of the last character changes, not the time 
of the formatting changes. 


Save does not take arguments when used as a macro command. 
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Save As 

Save As... allows the current file to be saved in a different 
folder, or under a.different name. Future saves of the file will 
use the new name or folder. Clicking the “Name only” button 
changes the name of the current file without immediately saving 
it. 


@ Save As 

If the file has changed, this will save the current file like Save, 
but will change its icon to the QUED/M document icon (in case it 
had some other icon.) 


@&Save As 
Attaches the QUED/M icon to all open documents. 


Macro Use 
The macro command 


Save As "Mourning" 


would save the current file with the name “Mourning” in the 
current folder. 


Save As “Electra” "" 


renames the document “Electra” but does not save it. (The 
second set of quotation marks are empty.) 


Revert 
Changes the document text back to the last version saved. Revert 
cannot be undone. (Option for all windows.) 


Revert does not take arguments when used as macro command. 


9¢ & Revert 


_ Updates all open documents changed by another application. If a 


file has been changed by another program when using 
MultiFinder, Option-Command-Revert will force QUED/M to 
read the changed version from disk into memory, replacing the 
current version. This is a useful command to put in the 
SWITCHIN macro. 
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Get Info Je. ee 
Displays an information window giving statistics, including a 
word count, for the file in the active window, as well as 
summary information about all open files. 


Get Info does not take arguments when used as a macro 
command. 


File window #1 


Number of lines: 215 chars: 10460 
Tab width :8 speces, 48 pixels. 
Line width :Not Set 


words: 1325 


Path name: HD20:DevTools:AsmTools:MDS Equates:FSEqu.Tut 


Original: HD20:DevTools:AsmTools:MDS Equates:FSEqu.Txt 
Last modified:Tue, Jan 21, 1986 2:12PM 
Keys hit: 0 


etbeeneseeeeeseeanseeseseee sane ses en eeeaesee sees see eeseeeeeeee 


Files opened 31 


Number of lines: 215 chars: 104¢0 words: 1325 





Figure 10° 


Options ; 
Brings up a dialog shown in Figure 11 for setting various user 


Saving options: 
(C1 Keep backups. 


Save after every |Pail)| key 
strokes. 


Typing and edit options: 
[J Remove leading blanks when typing. 
{J Remove trailing blanks when typing. 
(2 Allow TAB characters In text. 


Maximum number of UNDOs: 


Scrolling options: 


Two-disk save: 


| oO Save any files from one of 
these disks onto both disks: 


First disk: 


f Auto horizontal scrolling. 

& Auto vertical scrolling. 
(Scroll to keep 3 lines in view. 
Scroll Speed: 


& Fractional Fonts. 
(0 Old Window Tiling Layout. 
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Keep Backups 

When checked, every time you Save a file, the previous version 
is kept as a backup. The backup file will have “.bak” appended 
to its name. 


Save After Every (250) Key Strokes 
When checked, an automatic Save is done after the number of 
key strokes specified. 


Two-disk Save 

When Two-disk save is checked, QUED/M will write the file 
onto two separate disks every time the file is saved. When using 
HFS, the two disk names can actually be two folders on the 
same disk. In this case, the full path name to the folders, starting 
with the disk name and separating folder names with colons, 
should be typed in to the “First disk” and “Second disk” boxes. 


If you specify the full path to HFS folders for a second “disk” 
which does not exist, QUED/M will create the folders. 


Remove Leading Blanks when Typing 
Removes spaces and tabs at the beginning of a new line, after 
Return is pressed. 


Remove Trailing Blanks when Typing 
oe the spaces and tabs at the end of lines terminated with 
a Return. 


Allow TAB Characters in Text 

If checked, QUED/M inserts true tab characters when the Tab 
key is pressed. If not checked, QUED/M enters spaces to 
represent the tab when the Tab key is pressed, no tab characters 
are inserted into the text. 


Maximum Number of UNDOs 

This is the depth of Undo actions which you want QUED/M to 
remember. The maximum is 32,767. Any typing after moving 
the I-beam is considered a separate action to be undone. One 
Undo is always possible even if 0 is specified. 


QUED/M maintains two lists: the Undo list and the Redo list. 
The Undo list continues accumulating all changes to the text up 
to the number set in the Options menu. This Undo list is not 
cleared when you save the file. The Undo list includes all 
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changes made in all the open files. As files are closed, the 
changes made in them are removed from the Undo list leaving 
the rest of it intact. It is completely cleared (that is forgotten) 
only when you close all the files in which changes have been 
made. Thus even after several saves you can go back to versions 
of files existing before those saves. 


The Redo list behaves differently. It begins its existence the first 
time you use Undo. Thereafter the Redo list is purged very time 
the text is changed. If you Undo some actions, you can change 
your mind and Redo them, provided you have not added new 
actions to the Undo list. Any new action clears the whole Redo 
list. 


Auto Horizontal Scrolling 
If checked, the window scrolls horizontally to keep the I-beam 
in view whenever text is typed, or the Enter key is pressed. 


Auto Vertical Scrolling 
If checked, scrolls vertically to keep I-beam in view. 


Scroll to Keep 3 Lines in View 
If checked, automatically scrolls vertically to keep 3 lines in 
view. 


Scroll Speed Option 


This item can be set to scroll more than one line at a time when - 


the scroll bar arrows are continually selected. Try it out to see 
which speed for scrolling suits you best. 


Fractional Fonts Option 

When checked, fractional spacing fonts are enabled allowing 
better character spacing when printing on the LaserWriter using 
LaserWriter Fonts. 


Old Window Tiling Layout 

This option allows tiling in a slightly different way. When 
checked, QUED/M will generally tile so that windows are at 
— as wide as they are tall. Try it to see which tiling layout you 
prefer. 


“Options” does not take arguments when used as a macro 
command. 
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Save Defaults 

Saves the Current state of all user options (including the transfer 
list and the state of all menu toggles) as resources in the 
QUED/M application file. They are saved for the next time you 
run QUED/M. The font name and size, line width, and tab 
settings are saved with the file (not with the program) at the time 
the file is saved. The font setting remembered with a file 
overrides the QUED/M setting when the file is opened. If the file 
has no font size or style set explicitly, then the current program 
setting is used. 


The error message “Unable to save defaults” could mean one of 
the following: 


¢ There is no room on the disk to re-save the QUED/M 
application, 

¢ QUED/M is software locked (I/O error = -61) 

¢ The disk is locked. 


To check for a software lock, select the QUED/M icon in the 
finder and choose Get Info from the File menu. If the “Locked” 
box in the Get Info window is checked, then the application is 
locked. Clicking the X will unlock the application and allow the 
new defaults to be saved. 


To unlock a locked disk, eject it by typing Command-Shift 1 
(internal drive) or Command-Shift 2 (external drive), then move 
the plastic tab in the comer of the disk case to close the hole. 


Save Defaults does not take arguments when used as a macro 
command. 
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‘ Load Macro File 


Loads any macro file using QUED/M’s special File dialog. It can 
also be used to create a new macro file by selecting New from 
the Other menu in the File dialog. 


Macro Use 
Load Macro File does not take arguments when used as a macro 
command. * 
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=== Print Format === 


Header Margin: [10 |mm 


XX Print page numbers 
KK Print title 
X Print date last modified 


Margins: 


CO Print time 

&] Background printing 

(X] Page feeds on FF (ASCII 12) 
C) Print hidden text 





Figure 12 


Printing Format 

Brings up a dialog as shown in Figure 12, for setting print 
margins and checking items to be included in a header on each 
page. In order to conform to a standard used in text files by 
other computers, QUED/M can also force the printer to start a 
new page wherever it finds the ASCII page feed character 
(ASCII 012, hex OC, ctrl-L) in the text of a document. This 
character can be entered by double-clicking on the appropriate 
code in the ASCII window (available by choosing Enter 
ASCIL... in the Special menu.) 


The Print Format dialog also allows setting whether or not 


hidden text should be printed, and turning on and off 
ImageWriter background printing. ' 


Printing Format does not take arguments when used as a macro 
command. 


Page Setup 

Allows you to set the size of the paper to be printed on, and 
whether printing should be done sideways or reduced. The page 
setup dialog is documented in the Macintosh user manuals. 


Page Setup does not take arguments when used as a macro 
command. 
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Print 

Brings up the standard Print dialog. QUED/M has automatic 
background printing, also called print spooling, when the 
Macintosh is printing directly to an ImageWriter printer. 
Background printing allows text to be edited while a file is being 
printed. Background printing only works when printing on the 
ImageWriter in the “Best” or “Faster” mode (not in “Draft” 
printing). 


Because all printing calculations must be done before 
background printing begins, there may be a short delay after 
clicking OK in the Print dialog. During background printing, the 
Print item in the File menu changes to Stop Print, choose this (or 
press Command-P) to cancel the background printing. 


To disable background printing, uncheck the “Background 
printing” option in the Print Format dialog from the File menu, 
This may be desirable if a print spooler is already installed in the 
Macintosh. (Universal abort) 


Print does not take arguments when used as a macro command. 


Quit. 
Returns to the Finder after offering to save any unsaved files. 


Quit does not take arguments when used as a macro command. 
11.3 Edit Menu 


Undo 

QUED/M allows you to Undo any editing operation. Undo will 
even reverse the effects of any Global or Multifile operation, 
Change All’s, and macro executions. 


The Undo item in the Edit menu includes a number assigned to 
the last editing change which occurred, as well as a description 
of that change. Choosing Undo repeatedly will undo each earlier 
change. Depending on the amount of memory available, this 
may allow you to Undo every editing action which occurred 
since starting to edit. ms 


After Undoing an action, a Redo item appears in the Edit menu 
allowing to redo whatever action was just undone. While Redo 
will allow you to negate the effects of any number of repeated 
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Undos, any editing of text completely erases the Redo list. 
Executing a macro which changes the text in a file will also erase 
the Redo list. 


The keyboard equivalent for one Undo is Command-z, for 
further Undos, it is Command-Shift-Z. Likewise for Redos, the 
first can be accomplished by Command-z, and additional Redos 
with Command-Shift-Z. This convention allows an Undo to be 
followed by a Redo by typing Command-z twice. Assign menu 
keys... in the Macros menu allows these Command key options 
to be redefined. 


The number of Undo actions QUED/M will attempt to remember 
can be set_up to a maximum of 32,767. In the Options dialog 
from the File menu the standard setting is 300. Keeping this 
number small will help to conserve memory. One Undo will 
always be available, even if this option is set to zero. 


Undo does not take arguments when used as a macro command. 


Cut 

Copy 

Paste 

The standard Macintosh Edit items operate on any window 
including the current clipboard. The copied or cut text is placed 
in the current clipboard replacing its contents. 


Copy can be used to copy selected file names in a File dialog 
when it is the frontmost window. 


Choosing Copy when no text is selected (that is, when the I- 
beam is flashing) will place the most recently deleted text into the 
clipboard. This can be useful for recovering an accidentally 
deleted block of text. 


Cut 


Copy 

If the Shift key is pressed and held while cutting or copying. 
The cut or copied material will not replace whatever is in the 
current clipboard, it is appended to whatever was in the 
clipboard. In this way you can collect pieces of text from 
different parts of a document or from different documents, and 
paste them together. 
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Macro Use 
Cut accepts one argument in a macro, the number of the 
Clipboard to put the cut text into. 


Copy in Macros needs none, but accepts up to two arguments. 
The first is the clipboard number of the destination for the copied 
text. The second argument, which is optional, designates the text 
to be copied. If no second argument is given, the selected text in 
the active window is copied. 


The second argument can also be a reference to one of the 
clipboards. In this case, the reference should be given in single 
quotes, to indicate that it needs to be interpreted by QUED/M. 
For example, 


Copy "2" '\cc! 
Copy "6" '\c9' 


copy the current clipboard into clipboard 2 
copy clipboard 9 into clipboard 6 


®@ Paste 

When you press and hold the Shift key while pasting, the text 
being pasted over will be copied into the current clipboard. That 
is, the selected text and the clipboard text will be exchanged. 


Paste accepts up to two arguments. The first one is a single digit 
argument in double quotes specifying which clipboard number 
to paste from. If there is a second argument, it is the text to be 
pasted over the selection. This is primarily useful when the Shift 
key is held down, for copying the previous selection to the 
clipboard. For example, 


@Paste "3" "Test" 


copies the selected text into clipboard 3 and then pastes “Test” 
into selection. See the examples.in Section 11.1. 


Clear 

Deletes any selected text in the active window. Choosing Copy 
with no text selected will place the text recently cleared into the 
current clipboard. 


Clear does not take arguments when used as a macro command. 
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Select All 

This will select all of the text in the file shown in the current 
window. It is equivalent in this context to a quintuple click (five 
successive clicks.) 


Select All can also be used to select all of the file names in a file 
dialog, or all of the ASCII characters in the Enter ASCII 
window. 


Macro Use 
Select All does not take arguments when used as.a macro 
command, 


Move Right 
Moves selected text to the right by one tab position. This adds a 
tab after every Return in the text. 


@Move Right 
With the Shift key pressed and held, the text is moved right by 
one space, rather than by a tab. 


Move Right does not take arguments when used as a macro 
command. 


Move Left 
Moves selected text left by one tab position. Move Left will have 
no effect on lines of text which have no tabs at their beginning. 


® Move Left 
With the Shift key pressed and held, the text is moved left by 
one space, rather than by a tab. | 


Move Left does not take arguments when used as a macro 
command. 


Upcase 
Changes selected text to uppercase. Moves the I-beam as 
described in Capitalize. 


Upcase does not take arguments when used as a macro 
command. 
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Lowcase 


Converts selected text to lowercase. Moves the I-beam as 
described in Capitalize. 


Lowcase does not take arguments when used as a macro 
command. 


Change Case 

Changes case of selected text, making lowercase letters become 
uppercase and v vice-versa. Moves the I-beam as described in 
Capitalize. 


Change Case does not take arguments when used as a macro 
command. 


Capitalize 
Changes the first letter of each selected word to uppercase. 


With the above four case commands, if no text is selected, the 
change will be made to the character immediately following the 
I-beam. The I-beam will then be moved as follows. 


¢ If the Shift key is not held down, one character to the 


right. 
© Ifthe Shift key is held down, to the beginning of the 
next word. 


Capitalize does not take arguments when used as a macro - 
command. 


Clipboard 

When checked, the currently checked clipboard is displayed on 
the screen along with your files. The clipboard window may, 
however, be hidden behind other windows. There are 10 
clipboards, numbered from 0 to 9. Only one clipboard at a time 
can serve as the “current” clipboard, its number is checked in the 
Edit menu. To change which clipboard is the current one, 
choose a clipboard number from the bottom of the Edit menu, or 
use the Command key equivalent. 


The clipboard can be resized like any other editing window. Full 
editing can also be done in a clipboard, in fact, while you are 
editing a clipboard, even cut and paste are available. You can 
undo actions while editing a clipboard, so long as you do not 
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switch to another window. The clipboards can serve as quick, 
scratchpad windows for editing. Printing a selection can be 
accomplished by selecting some text, copying it, bringing up the 
clipboard’s window, and then choosing Print. 


Macro Use ; ; ; 
The Clipboard command is equivalent to choosing “Clipboard” 
from the Edit menu, it toggles the item on and off. 


Clipboard "on" 


opens the current clipboard window (if it is not already open) 
and brings it to the front 


Clipboard "off" 
hides the clipboard window. 


Clipboard 5 
will make Clipboard 5 the current clipboard. 


Intelligent Cut and Paste acd 
This option affects only text selected by double-clicking. With 
intelligent Cut and Paste checked, when words selected by 
double-clicking are cut or deleted, any extra spaces around 
where the words were will be removed, if the words are pasted, 
spaces will be added to keep the words separate from the 
surrounding text. Intelligent Cut and Paste does not affect words 
which may have been selected on a character by character basis. 


Intelligent Cut and Paste does not take arguments when used as 
a macro command. 


Clipboard 0 

Clipboard 1 

Choosing a Clipboard from the Edit menu makes that clipboard 
the “current” one for cutting and pasting. Clipboard 0 is the 
default. See the description of Clipboard. 


Macro Use : ; 
Command to make clipboard number 8 the current clipboard is: 


Clipboard 8 
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The macro command Clipboard can take two arguments, 


j Clipboard "on" 
Clipboard "off" 


11.4 Search Menu 


Find 

The Find dialog has buttons for searching forward from the I- 
beam position to the end of the file, Find Next, and backwards 
to the beginning of the file, Reverse. The dialog contains check 
boxes for enabling Regular Expression and Whole Word 
searching. Regular Expression searching is described in Section 
6, Whole Word searching should be turned off when attempting 
to find parts of words, or individual characters or even whole 
words which include characters not normally in words. 


To search for Tab or return characters with the Regular 
Expression tured off, press and hold hold the Shift key while 
typing the Tab or Retum keys. 


To search for expressions in unopened files, place the files on 
the search list (use Add to search in the Other submenu of the 
Open file dialog) and choose Multifile search from the Search 
menu. Regular Expression searching for the beginning and end 
of lines cannot be done in unopened files. This is because the 
file is never placed into a window, and so line starts are never 
calculated. (Universal abort.) 


Macro Use 
The expression to be found is used (in single or double quotes) 
as the first argument of Find. The second argument is optional, 
but can be used to set the various options as with Change. 
Section 11 contains a list of macro arguments which can be used 
in the second set of quotes. 


With Multifile searching enabled there are two special cases of 
this command in which the second argument is "X". The first 
Case is with an empty first argument as in: 


Find ©" © 


This requests a search of nothing in the unopened files on the 
search list. QUED/M will thus copy to the current clipboard the 
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full path names of all the files which are in the search list (the 
ones marked with an eye icon in the Open file dialog.) You can 
then paste this list into any file. In this special case searching is 
not performed, and the files are removed from the search list. 


In the second special case the first argument is not empty as for 
example, 
Find "London Museums" "X" 


This special case of Find will search through all the files on the 
search list for the words “London Museums”. The full path 
names of all files containing these words will then be copied to 
the current clipboard. No files will be placed on the screen in the 
process. 


Find 
Finds again the text in the Find dialog, without bringing the Find 
dialog window to the front. 


Change 

Chddeng Change brings up the Change dialog, which includes 
buttons for finding and changing one or all occurrences of an 
expression. Holding down Option while clicking the Change All 
button in the Change dialog will only change occurrences of the 
target expression in the currently selected portion of text. 


Macro Use 

When invoked with no arguments, Change brings up the 
Change dialog. Change can also be invoked with two or three 
arguments. The first argument is the target string to be found, 
the second is the replacement string. The third optional argument 
can be given for setting various options, these are listed in 
Section 11. All Changes, including Change All’s, can be 
undone. (Universal abort.) 


Jump 

Asks for line number or marker name, and moves the insertion 
point to the specified line or marker in the file being edited. If no 
line number or marker name is given, a default of “END”, 
meaning the end of the current file, is assumed. 


To jump to a line number, choose Jump and type in the line 
number into the dialog. To jump to a marker, either type in the 
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marker name instead of a number into the Jump dialog, or 
choose the marker name from the Search menu. 


Jump 

If the shift key is pressed and held when doing a Jump, all of the 
text jumped over is selected. This is particularly useful when 
selecting text in macros. 


The following steps will select a region of text from the 
keyboard or within a macro. 


° — the end of the region, set a (temporary) marker 

ere. 

* Find the beginning, then with the Shift key pressed 
and held, Jump to the temporary marker by selecting 
its name from the Search menu. In a macro use Jump 
"Temp" where “Temp” is the marker name. 


€Jump 

If the Option key is pressed down and held when Jump is 
chosen, the marker name typed into the dialog will be deleted, 
rather than jumped to. A marker can be deleted more quickly by 
pressing and holding the Option key while choosing its name 
from the Search menu. 


Macro Use 


Inside a macro you can jump to a marker named “Herbert 
Hoover” with the command: 


Jump "Herbert Hoover" 


The macro command: 


@Jump "Plato’s Retreat" 


will select the text between the current insertion point position 
and the marker “Plato’s Retreat”. 


@Jump “home" "work" 


will select text between the two markers “home” and “work”, 
These can also be line numbers or words,"START" or "END", 


Jump "12" 
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will jump to line number 12. 
@Jump "12" 


will select text from the current position of the insertion point to 
the beginning of line 12. 


The word END (all capital letters) is used to designate the end of 
text when jumping. To designate the start of text use "1", that is 
the first line of text. 


Set Marker 

Prompts for a name with which to mark the current position of 
the insertion point in the active window. The name will be added 
to the end of the Search menu. When the new marker is chosen 
from the Search menu, or entered in the Jump dialog, the 
insertion point will be moved to the marked position. 


To delete a marker, hold down the Option key when choosing 
the marker name or Jump from the Search menu. Section 5 
contains a more complete discussion of marker names. 


Macro Use 
The macro command: 


Set Marker "Freud" 


will place a marker called “Freud” at the current position of the 
insertion point in the active window. You can also create two 
markers with one co: 


Set Marker "Here" "Eternity" 


will set the marker “Here” at the beginning of the selected text, 
and the marker “Eternity” at the end of selected text. 


Auto Wrap 

All searches begin at the current insertion point. When Auto 
Wrap is on (checked in the Search menu), searches will wrap 
around, that is, continue, from end of file to the beginning. 
With Auto Wrap off, they stop at the end of the file. If the item 
being searched for appears only once in the file, with Auto Wrap 
turned on, subsequent searches will appear to do nothing. Auto 
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Wrap must be on if you want to change or find an expression in 
the file without regard to the position of the insertion point. 


Macro Use 


Auto Wrap can be turned on or off directly from within a macro 
with this command: . er 


Auto Wrap "on" 
Auto Wrap “off” 


Alternatively, placing A or W or -A or -W in the last argument 
of a Find or Change macro command will temporarily enable or 
disable Auto Wrap searching. 


Ignore Case 


With Ignore Case checked, Finds and Changes will ignore 
whether letters are upper or lowercase. 


Macro Use 
Global Search can be turned on or off directly from a macro, 


Ignore Case “on" 
Ignore Case "off" 


Using the command: 
Ignore Case “on" 
means that the case will matter in subsequent searches. 


The letter i (Ignore Case) or -i (do not Ignore Case) can be given 
as an argument in Find or Change macro commands. 


Find "Paragon" min 
will find “paragon” as well as “Paragon” but 

Find “Paragon” “-i" 
will only find “Paragon”. 


Global Search 
When Global Search is turned on (checked in the Search Menu), 
Find and Change will be applied to all open files. 
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Macro Use_ | ee 
Global Search can be turned on or off directly from within a 
macro, 
Global Search “on" 
Global Search "off" 


Multifile Search Ste, 

When checked, this item indicates that any search will include 
files which are selected for search (that is are on the search list) 
but not opened. You can add unopened files to the search list by 
selecting the file names and choosing Add to Search from the 
Other submenu of the Open file dialog. Files on the search list 
are marked with an “eye” icon. Multifile Search can be turned 
off to temporarily disable unopened file searches without 
changing the search list. a 


Macro Use 7 
Multifile Search can be turned on or off directly from within a 
macro with, 
, Multifile Search “on" 
Multifile Search “off" 


The letter “‘m” can be used as the last argument ina Find or 
Change command to turn Multifile Search on or off temporarily. 


Find “Algebra” "m" 


will search for the word “Algebra” with Multifile Search 
temporarily turned on. 
Find "Algebra "-m" 


will search for the word “Algebra” with Multifile Search 
temporarily turned off. 


At the end of the Search menu, a list of available markers will 
appear, starting with markers for the file in the active window. 
See Section 5 for information on using markers. 


11.5 Format Menu 
Stack Windows 


Arranges windows in a stack, resizing each to a uniform size. 
Each new set of four windows restarts the overlaying process, It 
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is slightly offset from the previous set. This applies to all open 
windows. 


Stack Windows does not take arguments when used as a macro 
command. 


Tile Windows 

Arranges windows so that if sixteen or less windows are open, 
all are completely visible. If more than sixteen windows are 
open, only sixteen will be completely visible when tiled; the rest 
will be stacked neatly behind the visible windows, but offset just 
enough so that every window is at least partially visible. 


If “Old Window Tiling Layout” is checked in the Options dialog 
(available by choosing Options... from the File menu) QUED/M 
will tend to tile windows, one above the another on the screen. 
Without this option checked, QUED/M will prefer side by side 
tiling of windows. This option is so named because it was 
standard on earlier versions of QUED. 


Tile Windows does not take arguments when used as a macro 
command. 


Resize Window 

Expands or contracts the active window as if its zoom box had 
been clicked, or its title bar double-clicked. If two windows 
have synchronized scrolling, resizing either window will arrange 
them side by side. 


Resize Window does not take arguments when used as a macro 
command, 


@Resize Window 
Resizes the two topmost windows so that they are side by side 
and use up the whole screen. 


€ Resize Window : 
Holding down the option key while choosing Resize Window or 
while clicking a window’s zoom box will open the windows in a 


Tiled format. 
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@ Resize Window 

Holding down the option and shift keys while choosing Resize 
Window or while clicking a window’s zoom box will open the 
windows in a Stacked format. 


Hide Text ; 

Text hiding can be used to reduce the text of a file to just the 
most important points, as in an outline. It helps programmers 
see the flow and construction of a program while hiding the 
distracting details. 


If you select a region of text and then choose this item, the 
whole selection (except for the first line) disappears, it becomes 
hidden but not deleted. In its place, the first line of the selection 
is displayed in a box. Try it to see the effect, we call this a fold 
in the text, it is similar to a fold in a piece of paper. 


Opening, Closing, Deleting Folds 

To show the text inside a fold, double-click the small black dot 
to the left of the boxed first line. To hide the text once more, 
double-click the black vertical line to the left of the text. This 
black line indicates the region of the fold. To remove a fold 
completely, double-click on this black region while holding 


down the Option key. You can nest the folds to any depth, that ~ 


is, you can open a fold, then select a portion of the text inside it, 
hide it, and repeat the process any number of times. You cannot 
however overlap (stagger) folds. If you attempt to create 
overlapping folds, QUED/M will beep and do nothing. 


When a fold is opened (the black dot is double-clicked) with the 
Shift key held down, all folds within it are also opened. If the 
Option and Shift keys are held down when opening a fold, all 
folds within it are removed, and all of the text within the folds 
becomes visible. 


To print hidden text, check the option in the Print Format dialog, 
by choosing Printing Format from the File dialog.) 


Macro Use 
Hide Text acts on selected text. It does not take arguments when 
used as a macro command. 
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Show All Hidden Text 

Hide All Hidden Text 

Use these menu items to make all hidden text in the active 
window visible or invisible. (Option for all windows) 


#% Show All Hidden Text 

If the Command key is held down when choosing Show All 
Hidden Text, all closed folds in the active window will be 
removed. The text within those folds, however, will not be 
deleted. (Option for all windows) 


3% Hide All Hidden Text 

If the Command key is held down when choosing Hide All 
Hidden Text, all open folds in the active window will be 
removed. (Option for all windows.) 


Macro Use 
Show All Hidden Text and Hide All Hidden Text do not take 
arguments when used as macro commands. 


Show Info 

Shows information about the active window below the title bar. 
Note that a black dot will always appear next to a file’s name if 
that file contains unsaved changes. Double-clicking the split 
window drag region, a small black rectangle, in the vertical 
scroll bar also turns Show Info on and off. (Option for all 


windows.) 


$< 
| echeckparen.c as 5 
57/2440 @DF20:Cris's Folder :Sources:checkparen.c (Lf 


1s displayed. Notice that ff a nen-matohing right : 
parenthesis is feund, the parenthesis set shown en 
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Sync Scrolling 
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“Recount Parens” again efter making the correction in 
hts text. 





Figure 13. 
The information below a window’s title bar includes: 


¢ The number of characters between the insertion point 
and the preceding return character. This is usually the 
number of characters between the beginning of a 
paragraph and the insertion point. Note that a press of 
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the Tab key counts as one character, unless it has been 
converted to explicit spaces. 

* The number of characters between the beginning of 
the file and the insertion point. 

¢ The words “Read Only” if the window cannot be used 
for editing. (The discussion of Open, earlier in this 
‘section explains opening Read Only windows.) 

¢ The full path name of the window’s file, possibly 
preceded by a black dot indicating that it contains 
unsaved changes. ; 

e The current unmatched parentheses, if Paren 
Checking is on. 

¢ An icon containing two arrows, if the window is set 
up for synchronized scrolling with another window. ° 


Macro Use W.* 
Show Info can be turned on or off directly from a macro, as in 


Show Info “on" 
Show. Info “off" 


Horizontal Scroll Bar 
When checked, a horizontal scroll bar will appear at the bottom 
of the screen for viewing files wider than the window. 


Macro Use 
Turn the horizontal scroll bar on or off from within a macro 
with, 


Horizontal Scroll Bar “off" 
Horizontal Scroll Bar "on" 


Sync Scrolling 

Synchronizes scrolling of the top two windows (the two 
windows most recently clicked in.) The scroll bar controls of 
each window affect both windows simultaneously. When two 
windows have synchronized scrolling, clicking the zoom box of 
either window (or choosing Resize Window, or double-clicking 
either title bar) will arrange them side by side. 


Macro Use 
Turn synchronized scrolling on or off from within a macro with, 


Sync Scrolling "on" 
Sync Scrolling "off" 
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AutoIndent 

When checked, ‘pressing Return to start a new line or paragraph 
introduces an indentation identical to that of the previous line. 
All tabs and spaces preceding the text on the previous line is 
reproduced at the beginning of the new line. The Backspace or 
Delete key will of course erase the indentation if it is unwanted, 


Macro Use 
AutolIndent can be turned on and off within a macro with, 


AutoIndent "on" 
AutoIndent “off"* 


Line Numbers 
Displays line numbers to the left of each line of text. Line 
numbers appear on screen and can be printed, but they are not 
saved with the file on disk. If a file exceeds 999,999 lines, only 
the first six digits of each line number will be displayed. (Option 
for all windows) 


Macro Use 
Line numbers can be turned on and off within a macro with, 


Line Numbers “on” 
Line Numbers “off" 


Show Invisibles . 
Shows tabs, spaces and returns as special visible characters. 
(Option for all windows) 


Macro Use 
Show Invisibles can be turned on and off within a macro with, 


Show Invisibles "on" 
Show Invisibles “off" 


_ASCII Codes 


Displays the hexadecimal ASCII code for each character. When 
both Show Invisibles and ASCII Codes are checked, only the 
non-standard characters (not including Tab, Space, and Return) 
have their ASCII codes displayed. In this case, the codes are 
enclosed in brackets. (Option for all windows.) 
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Macro Use 
ASCII Codes can be turned on and off within a macro with, 


ASCII Codes "on" 
ASCII Codes "“off" 


Set Tabs 

Brings up a dialog for setting the number of characters each tab 
width should represent. The character width, in this context, is 
the width of a numeric character in the current font. (Option for 
all windows) , 


Set Tabs does not take arguments when used as a macro 
command, 


Set Line Width 

Brings up a dialog for setting the width of a line. The number 
typed in to the dialog is in terms of the width of a numeric 
character in the current font. QUED/M uses this value to 
determine where line wrapping should occur. The number 
initially in the dialog is the current width of the window. The 
maximum line width is equal to the width of 378 characters in 9 
point Monaco font. The minimum line width is equal to the 
width of 20 Monaco 9 point characters. 


Operations on very large files will be slowed down considerably 
if a line width is set. Changing the line width for long files may 
take some time to complete, a line width change cannot be 
undone once it is made except by setting it once more. (Option 
for all windows.) 


Macro Use 
Set Line Width does not take arguments when used as a macro 
command. The response to the dialog must be typed by the 
macro, as in this example.Note that there is a space at the end of 
the last “Key ” command, 


Set Line Width 
Key 59 
Key 


This macro will set the line width of the current window to 59 
characters. 
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11.6 Font Menu 


} 
Font Sizes 
Selecting a new point size changes the font size in the active 
window and makes it the default size for subsequent new files. 
The size checked in the Font menu is the size of the font in the 
active window. Only one font size can be used within each 
document. 


The sizes shown as outlined characters in the Font menu are the 
sizes which will appear best when printed on an Image Writer. 
The font size of the Open file dialog can also be changed. 
(Option for all windows.) 


Macro Use 
The macro command to change the current font size is the same 
as the size entry in the Font menu, such as: 


18 Point 


Fonts 

Selecting a font name changes the font in the active window and 
makes it the default font for subsequent new files. The font 
name checked in the Font menu is the font of the active window. 
Only one font can be used within each document. 


QUED/M saves the tab setting, font, and font size with each file 
in the resource format used by the editor MDS Edit. Hence, 
those settings will be retained when you use QUED/M to edit a 
file that was created with MDS Edit. 


The font of the Clipboard is always Chicago. A change of the 
font or size of the clipboard is forgotten once the clipboard 
window is closed. The font of the Open file dialog can also be 
changed. (Option for all windows.) 


Macro Use. 
No arguments are allowed. Any font can be selected by a macro 
by using its name exactly as it appears on the menu, for 
example, 


Monaco 
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11.7 Transfer Menu 


Transfer 

Puts up an dialog showing application file names, and launches 
the selected application. Use Edit Transfer... to add the names 
of frequently used applications to the Transfer menu. 


Macro Use 
Transfer will accept an argument in double quotes, specifying 
the application name and, if necessary, the full path to the 
application. To transfer to the program “MacWrite” in the “Wrd 
Proc Folder”, you would use the macro command: 


Transfer "Wrd Proc Folder:MacWrite" 


Edit Transfer 

Allows you to add or remove application names in the Transfer 
menu. It brings up a window with listings of the application 
names currently in the Transfer menu. The usual QUED/M 
editing features are available for adding or removing application 
names on the list. 


To access programs in any folder, you have to type the full path 
name of the application, beginning with the disk name. The disk 
and folder names should be separated by colons. For example, if 
you want to add the program MacTerminal to the Transfer list, 
and MacTerminal is inside of a folder named “Terminal 
Programs”, which is itself inside of a folder called 
“Communications”, all on the disk ““HD20”. You would type, 
on one line in the Transfer Menu window the following, 


HD20:Communications:Terminal Programs:MacTerminal 


Note that a path name must not be longer than 255 characters, 
either in the Transfer Menu or in any macro argument. 


Macro Use 
Edit Transfer does not take arguments when used as a macro 
command. 


Key Equivalents 

You can put Command key equivalents for transferring to other 
applications on the Transfer menu. Just follow any program 
name with a slash and the character to use as its command key 
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equivalent. To put the program "Great Game" in the Transfer 


menu with the Command key equivalent %#K, its line in the 
Transfer Menu window would look like: 


Great Game/K 


Because of this, applications with slashes in their names cannot 
be added to the Transfer menu unless they are first renamed. 


File Transfer 

There are several additional features available when adding items 
to the Transfer menu. These features are useful when 
transferring to a compiler, development system, or word 
processor. 


e If <tab>myFile follows an application name in the 
Transfer Menu window, the file myFile will be 
opened when that application is transferred to, using 
the Transfer menu. 

e Adding <tab>% after the name of an application on 
the Transfer Menu window will cause the file in the 
active QUED/M window to be transferred to that 
application and opened. 

e Placing <tab>%% after an application name will cause 
all open files to be transferred to that application. 


Transfer and Print 
To print all open files from QUED/M, enter the following item 
into the Transfer Menu window, (<tab> means the tab key). 


QUED-M 2.0<tab>%%-p<tab>%% 


and then choose it from the Transfer menu. This will restart 
QUED/M, and will start all open files printing. Because 
QUED/M can print files in the background (ImageWniter only!), 
you will immediately be able to resume editing, 


For this to work you must rename the program QUED-M, the 
name QUEDIM cannot be used since the slash “/” has a special 
meaning in the Transfer menu. 


Application Names 
The Transfer menu contains the names of applications which 
have been added through the Edit Transfer procedure described 
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earlier. Choosing an application name from the menu will cause 
QUED/M to quit, and the chosen application to be run. 


If the Option or Shift key is held down while selecting a 
particular program to transfer to, the current disk will not be 
changed. (Universal abort) 


11.8 Special (Memory) Menu 


The name in the menu bar for the Special menu is the amount of 
free memory while running QUED/M. The maximum value this 
can indicate is 999K bytes of available memory. If you are 
running QUED/M under MultiFinder, be aware that this number 
reflects the memory free in the space allotted to QUED/M, not 
the memory which may be free for other applications to use. 


Compact Memory 
Forces the Macintosh memory manager to compact the heap. 
This has no effect on the file being edited. 


Compact Memory does not take arguments when used as a 
macro command. 


Balance Parens 

Selects the region between the two matching parentheses on 

either side of the I-beam, or beeps if an appropriate parenthesis 

pair is not found. Balancing Parens repeatedly will attempt to 

find the next outer sets of matching parentheses and select the 

pe between them. Parentheses are defined in the Set Parens 
og. 


Balance Parens does not take arguments as a macro command. 


Recount Parens 
Checks entire file for mismatched parentheses. The check stops 
at the first unmatched parenthesis. (Universal abort.) 


Recount Parens does not take arguments as a macro command. 


Set Parens 

Brings up a dialog for defining pairs of parentheses. Up to six 
pairs of expression parentheses and six pairs of string delimiters 
may be defined. 
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Expression parentheses (delimiters) surround any kind of text, 
and are generally defined as program elements which must 
appear in pairs. String delimiters generally mark the start and 
end of comments or character strings in programs. Strings inside 
of string delimiters are not checked for other kinds of 
parentheses. © 


Examples of common expression parentheses: 


( ) 

[ ] 

{ } __ for the programming language C 
begin end for the language Pascal 


Examples of common string parentheses: 
ily we 


~~) e for writing in English 

Py for C comments 

ee for Pascal comments 

; Shift-Return for assembly language comments 


When defining the closing assembly language comments 
delimiter, the Shift key must be held down while typing the 
Return key to prevent the Return from being interpreted as a 
click of the OK button. When the ; and Return are defined as a 
pair of parentheses, a return at the end of a line which does not 
have a semicolon will not be interpreted as a closing unmatched 
parenthesis. 


Macro Use 
Set Parens does not take arguments when used as a macro 
command. ' 


Paren Checking 

QUED/M checks for mismatched parentheses. The first one or 
two characters of any currently unclosed parenthesis are 
displayed in the information bar at the top of a file editing 
window. For example, if “begin”,“end”, “(” and “*)” have been 
defined as parentheses, typing “begin (” will give the indicator 
“be(’”’ in the information bar. 


With Paren Checking turned on, a beep will sound if you enter a 
closing parenthesis not balanced by a previous opening one, 
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except in the special case of the Semicolon-Return pair, as 
mentioned in the description of Set Parens, above. As you close 
each opened parenthesis, the opening one is removed from the 
Show Info bar. By looking at the Show Info bar as you type, 
you can determine if you have followed all opening parentheses 
with appropriate closing parentheses. 


Macro Use 
Paren Checking can be turned on and off within a macro: 


Paren Checking "on" 
Paren Checking "off" 


Zap Gremlins 

Deletes “illegal” characters, invisible characters which often give 
compilers, printers, or other computers trouble. The set of 
characters considered illegal can be changed using a resource 
editor such as ResEdit, but Paragon Concepts Inc. cannot 
undertake to provide support or detailed information on how to 
do this. An easier way to zap a specific set of characters is to 
create a macro which deletes whatever you specify. The 
following macro will delete characters defined inside the braces: 


Change "[{\0- #- ~]" to "" "“-waT" 


where the set picked for the example defines a Gremlin set in 
two ranges of ASCII codes. The first range begins at ASCII 
zero (entered as \0) through ASCII 31 (which is only visible on 
the screen if you turn on ASCII Codes) and the second begins at 
the character # (which is visible in the Chicago font) and ends at 
the last character in the ASCII table (255, which will also not 
appear on screen). The fact that the characters are not visible 
does not stop them from being recognized and deleted by 
QUED/M. (You may not be able to type them at the keyboard, 
so use the Enter ASCII feature of QUED/M to paste in the 
invisible characters.) You can specify characters to be deleted in 
any number of ranges. Section 7 has more information on 
defining Regular Expressions. 


Macro Use 
Zap Gremlins does not take arguments when used as a macro 
command. Zap Gremlins is implemented as a built-in macro. 
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Gremlin Alert 
When checked, causes a beep if an Option or Shift-Option 
character is typed. 


Macro Use 
Gremlin Alert can be turned on and off within a macro. 


Gremlin Alert "On" 
Gremlin Alert "Off" 


Enter ASCII 

When selected, a narrow “Read only” window is opened, as 
shown in Figure 14. This window contains all of the visible and 
invisible ASCII characters, as well as their decimal and 
hexadecimal values. Characters from this window can be 
accessed in several ways: 


¢ They can be selected and copied from the ASCII 
window, and then pasted into another window. The 
Select All item in the Edit menu will select all of the 
characters in the ASCII window for copying. 

¢ Double-clicking on a character in the ASCil window 
will cause that character to be pasted into whatever 
window was active before Enter ASCII was chosen. 
This also works when entering text into Find and 
Change dialogs. 

¢ If the ASCII window is visible but is not the active 
window, command-double-clicking on a character in 
it will paste the character into the active window. 


The ASCII window is especially useful for entering characters 
not available on some keyboards. Changing the font of the 
ASCII window allows you to see what characters are available 
in the different fonts. 
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File Edit Search Format Font Transfer 999+K 





Figure 14 


Macro Use 
Enter ASCII does not take arguments when used as a macro 
command. 


Sort Lines 

Sorts the selected lines of text. Any line partially selected will 
also be included in the sort. Sort Lines only affects lines which 
explicitly end with a return. If a line width is set for wrapping 
text, Sort Lines will actually sort paragraphs. 


If the first character of the selected text is numeric, the sort will 
be done numerically, ignoring spaces which preceded numbers 
on a line of text. Otherwise, the sort will be done alphabetically. 
Numerical sorts place lines beginning with letters before lines 
beginning with numbers, alphabetical sorts place numbers 
before letters. 


Sort Lines 

In all sorting the leading spaces and tabs are omitted from 
consideration unless the Shift key is held down before and 
during selection of Sort Lines. 
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€Sort Lines 

All sorting is performed strictly according to the ASCII values of 
the characters in each line when the Option key is held down 
before and during selection of Sort Lines. 


Macro Use 
Sort Lines does not take arguments when used as a macro 
command. 


Compare 

This becomes highlighted when there are at least two files open. 
This feature compares characters in the two top windows, 
Starting at the position of the insertion point in each, and places 
the insertion points at the position of the first difference.The two 
top windows are the windows of the two files most recently 
clicked in. If no difference is found, QUED/M will state soina 
dialog. 
€Compare 

Holding down the Option key while choosing Compare makes 
QUED/M ignore differences in spaces, tabs, and returns. In this 
Case, one space, tab or return is treated the same as many 
contiguous ones. If there are none of these characters at some 
point in one file and there is one or more in the same position in 
the other, a difference will be found by Compare. 


Macro Use 
Compare does not take arguments when used as a macro 
command. 


Break Lines : 

Causes explicit returns to be inserted at the end of every 
wrapped line of text. This is useful for preparing text for 
transmission to other computers, or for transferring text to 
programs which cannot automatically wrap text. 


Macro Use 
Break Lines does not take arguments when used as a macro 
command. 
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@Break Lines 

Breaks lines as described above, but also adds a return character 
wherever there already is one. Thus, paragraphs become 
separated by a blank line. 


Change Tabs->Spaces 

Replaces tabs in the selected text with the number of spaces 
which most closely approximates the tab spacing. This 
replacement exactly preserves the tab spacing when using a 
monospaced font (like Monaco and Courier.) The replacement in 
proportionally spaced fonts occasionally does not match the 
previous tab alignments. This feature is useful in preparing text 
to be moved to other programs or computers which cannot easily 
display and manipulate tabs. 


Macro Use 
Change Tabs->Spaces takes no arguments when used as a 
macro command. se 


Change Spaces->Tabs 

Replaces spaces in the selected text with tab characters, 
maintaining approximately the same spacing. For proportionally 
spaced fonts, it is possible (due to round-off errors) for a Tabs- 
>Spaces followed by a Spaces->Tabs not to reproduce the 
original text precisely. It is therefore better to use Undo to 
reverse either of these commands. 


Macro Use 
Change Spaces->Tabs takes no arguments when used as a 
macro command. 


11.9 Macros Menu 


Record Macro 

Starts recording actions in the active window. The item changes 
to Stop Recording after being chosen, choose it again to leave 
the recording mode. 


Macro recording is useful while you are learning to write 
macros. Even when you are comfortable, it is often a convenient 
way to enter the characters corresponding to the Shift, Option, 
Command, and Caps Lock keys. 
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While Record Macro is on, every menu item chosen, as well as 
the macro commands for any typing done will be written by 
QUED/M in the window that was active when macro recording 
was begun. All editing during macro recording will take place in 
whatever window is active. Mouse clicks and drags are not 
recorded in macros. 


Quite often you will find it convenient to use one of the 
clipboards to create the text of a macro. Do not execute the 
macro from the clipboard, since it could be overwritten by a 
Copy command. Instead, paste the clipboard contents into a file 
window and execute it from there. 


. Macro Use 
Record Macro takes no arguments when used as a macro 
command, 


Edit Macro 

Asks for the name of a macro to edit. The default name is “my 
macro”. Be sure any name you give a macro is unique. It may be 
difficult to refer to it later if there is a conflict of names. (The 
name you choose will eventually appear on the Macros menu.) If 
you want to edit an existing macro, either type the macro name 
into Edit Macros dialog or choose the name from the Macros 
menu, then click the Edit button to open it in a macro window 
for editing. A quicker way to edit an existing macro is to hold 
down the Shift key while choosing the macro name from the 
Macros menu. 


Macro Use 
Edit Macro takes no arguments when used as a macro command. 


Execute Macro - 

Executes the selected text in the active window as a macro. This 
is a useful way to try out small macros, or parts of macros. 
When Execute Macro is chosen, the active window is moved 
behind all other QUED/M windows, and the macro text is 
executed on whatever window has become the new top window. 


Macro Use 
Execute Macro takes no arguments when used as a macro 
command. 
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Assign Menu Keys 

Brings up a Menu Keys window for entering user-defined 
Command key equivalents. With the Menu Keys window you 
can add or change Command key equivalents for any item on 
any menu, including the Apple, Edit, Fonts, and Macros menu. 
To assign a Command key equivalent to a menu item, enter the 
name ofthe item in the Menu Keys window, followed 
immediately by a slash character ( / )followed by any 
alphanumeric key equivalent. 


For example, to allow switching to the Chicago font by typing 
Command-7, enter this line into the Menu Keys window, 


Chicago/7 


You can edit or add new key equivalents at any time. You can 
also assign Command key equivalents to any macros or markers 
you have created. Note however that no checking of what keys 
you define is done by QUED/M. If you assign a key to an item 
which is not on any menu, nothing will happen. If you assign a 
name which appears twice on the menus, the key will access one 
of the menu items but not the other. To cancel a previously 
assigned key, remove the slash “/’ and the symbol following it, 
but leave the menu item. 


The menu keys defined in the Menu Keys window override the 
built-in QUED/M keyboard equivalents. If a Command key 
equivalent given for Redo is not the same as for Undo (which is 
usually Command-z) then typing the Undo Command key 
equivalent repeatedly causes multiple Undos to be performed. 
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12 KEYBOARD COMMANDS and SHORTCUTS 


Notation 
We remind the reader once more of the modifier key symbols 
used throughout this manual: 


3 = Command symbol 
@ = Shift symbol 
€ = Option symbol 


The following listings are a summary of some keyboard 
commands. Since you can change and add command key 
equivalents to any menu item, we do not generally list these. The 
keys listed here include many convenience features. Some of 
them make it possible for you to write sophisticated macros. 


The functions of various keyboard commands is heavily 
dependent on the context in which they are used. 


12.1 Selection and I-beam Movement In Document 
Windows 


Text Selection 
Mouse Clicks 
You can select text using the mouse in the following ways: 


¢ Drag from the beginning to the end to select any 
region of text. 

¢ Double click in any word to select the word. Double 
click and drag to select a group of words. This is 
necessary to use Intelligent Cut and Paste feature. 

e Triple clicking selects a line on the screen. 

¢ Four quick clicks selects a paragraph, that is a region 
between explicit return characters. If the line width is 
not set, a line and paragraph are the same thing. 

¢ Finally, five clicks in rapid succession selects the 
whole document. This is the same as choosing Select 
All from the edit menu. 


The following is a list of other ways to select text. 


#¢¢é return Select to the end of paragraph (that is to 


and including the return character). 


9% ¢@ Space 


98 @ & Backspace 
3 Backspace 
36 @Enter 

3 Return 

3 @Space 


@ Backspace 


Backspace 


3€ Backspace 


€ % Backspace 


3 Space 


€ % Space 
3€ Return 


€%X Retum 
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Select from I-beam or end of selection, to 
end of word, including the space 
following, if any. 


Select from I-beam (or beginning of 
selection) to beginning of word. 


Select character to left of I-beam. 


Select from I-beam (or selection 
beginning) to the beginning of the 
paragraph. 


Select from selection end to end of 
paragraph. 


Select the character to right of I-beam. 


Text deletion 
Delete the previous word. 


Delete the previous character. 


I-beam Movement 


Moves one character backwards. If text is 
selected this will de-select it and leave the 
I-beam at the left of the selection region. 


Backwards one word. 


Forward one space. If text is selected this 
will de-select it and leave the I-beam to 
the right of the selection. This is useful 
within Macros. 


Forward one word. 
Move to beginning of next line. 


Toggle AutoIndent and Jump to 
beginning of next line. 


TODCOQOCOGeesees 


Enter 


96 @ Enter 

@<Marker choice> 
12.2 File 

3 Return 


36 Return 


Enter 


Enter 


Space 


3D or TAB 
#E 
aA 
3#R 


@ double-click 
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Move to beginning of previous line. 


Toggle AutoIndent and Jump to 
beginning of previous line. 


Extends current selection to that marker. 
SHIFT-Jump to a line number or to a 
marker does the same. 


In File Dialog 


(or Down Arrow). Selects the file or 
folder name in the file dialog. 


(or % Down Arrow). If a file name is 
selected, select the next file or folder, if a 
folder name is selected, open it. 


(or Up Arrow). Select the previous file or 
folder. 


(or 3 Up Arrow) Go to parent folder, or 
if none then click Drive. 


Selects the first file name in the file 
dialog. 


Changes the drive. 


Ejects current drive. 


~ Add selected file to search list. 


Remove selected files from search list. 


(Shift double-click on a file’s name in the 
Get File dialog) when opening a file 
causes a read-only duplicate to be open if 
one is already open. Double-clicking 
(without the shift key) on an open file’s 
name simply brings it to the front. This is 


@Open 


€double-click . 


€Open 


€Remove 


Return or Enter 


36\ 


96 @ Revert 


9 Revert 


Revert 
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useful when using the Open file dialog as 
a “windows” menu. 


Opens selected file, just like clicking 
Open without the Shift key down. If the 
same file is already open, then this will 
open a second, Read Only copy 


(On file name). Next file opened to be in 
tiled format. 


Same as @double-click. 


Remove all files in all directories from the 
search list. 


Open the highlighted file or folder. 


Toggle the Text Only button in the Other 
pop-up menu on the Open dialog 
window. 


File Reverting 


Reverts windows whose files on disk 
were modified. This is useful when 
switching (using the Switcher or 
MultiFinder) into QUED/M from another 
—_ which may have modified the 
iles. 


(Use pull down or in macro only.) 
Reverts the top window Only if the file 
on disk is more recently modified than the 
one in memory. It also prevents 
INITREVERT from being executed. 


Reverts the top window regardless of 
whether it has been modified. Useful if 
you have changed something in the file 
format (rather than text) which is not 
regarded as an actual change by 





96 & Revert 


Revert 


& @Revert 


Save 


€ Save 


@Save As 


€ Save 
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QUED/M. For example, if you fold or 
unfold text, or insert or delete a marker. 


The same as above but for all open files. 


Reverts all open documents modified by 
QUED/M. 


Reverts all open documents. 


File Saving 


Saves all modified documents with their 
original icons. 


Saves all open documents with their 
original icons. 


Saves all modified documents with the 
QUED/M icon. 


Saves all open documents with QUED/M 
icon. 


12.3 Find & Change 


oF 


#eS 


(or @Find) Find the expression in the 
Find box even when the Search dialog is 


‘not in front. (Repeat find). 


(or @Change) Does Change, then Find 
even when the Search dialog is not in 
front. 


The following work only wits the Search or Find dialog as the 


front window. 


#B 


Enter or Return 


Reverse (backwards) find. 


Means Find next when the Find dialog is 
the top window. 


eS 


€Change All 


GiXA 
9eW 


3P 


3\ 
3G 
3N 


12.4 INIT Macros 


140 


This is the key equivalent of “Change, 
then Find” when the Find dialog is the 
top window. 


(That is hold the Option key down and 
click in the Change All button of the 
Change dialog.) Does a Change All on 


just the selection region of. the top 
window. 


Change All. (Note two keystrokes!) 


Whole Word. Turns “on” whole word 
toggle. 


(Partial Word) Turns “off” the whole 
word toggle. 


Toggle Regular Expression. 
Turn Regular Expression searching on. 


Turn Regular Expression searching off. 


%# double-click file name 


#% New 


% or © or € 


12.5 Fold 


@ €double-click 


Suppresses INITOPEN macro from 
being executed when opening a file. 


Suppresses INITNEW from being 
executed, 


Held down when starting up will prevent 
the INITINIT macro from executing. 


on the fold indicator, deletes all folds 
within the one clicked. 


a 
—_ 
CO 
om 





®@ double-click 


€ double-click 
12.6 Markers 


€ Marker Name 


Marker Name 


141 


on the fold indicator, opens all folds 
within it. 


on the fold indicator, deletes the fold. 


Deletes a marker (NOT SHIFT as in 
QUED) . 


Selects the region between the I-beam and 
the Marker, 


12.7 Miscellaneous 


€ @ Click zoom 


€ zoom 


_@ Click zoom 


3N 


3N 


ae Y 
#Q 


Break Lines 


(The zoom box in the window) Stacks 
windows. 


Tiles windows. 


(The zoom box in the window) Zooms 
two top windows side by side. Repeat 
this and windows return to their old sizes 
and positions. 


Cancel or Abort. Most operations can be 
aborted. You may have to hold these two 
keys in the down position until the abort 
occurs. 


Name, do not save. (When the Save 
dialog is in front.) 


No, in answer to yes/no dialogs. 


Yes in answer to yes/no dialogs. 


Quit. 


Puts an extra return wherever there 
already is a return (thus, a blank line is 
inserted between paragraphs). 


Compare 


#Copy 


@Cut 


Macro Name 


@ Macro Name 


Arrow Keys 


9¢ & Double Click 


3 Double Click 


142 


Substitutes any sequence of blanks with 
one blank before comparing. Compares 
ignoring white space differences. 


(or %@C) Adds highlighted text to 
previous contents of the Clipboard 
(instead of replacing them). 


(or 9 @X) Cuts the highlighted text and 
appends it to the clipboard. 


Open macro file for editing. (Hold Shift 
key down while selecting the macro name 
from the Macros menu.) 


Deletes the macro if the Edit Macro dialog 
is in front. 


The arrow keys (if available) can be used 
to move the I-beam. 


There is a built-in COMMANDOPTION 
macro which exchanges the selection with 
Clipboard 9. This means that if you hold 
the Option and Command keys down and 
double-click on a word, the word will be 
selected and so exchanged with whatever 
was in Clipboard 9. You can write your 
own COMMANDOPTION Macro, 
which will then override this built-in 
macro. If you want to disable the built-in 
macro, you should create your own 
COMMANDOPTION macro without any 
commands. 


There is a built in COMMAND macro 
which copies the selection to the find 
dialog. If you hold the Command key 
down and double-click on a word (hence 
selecting it) you will find it copied to the 
find dialog. If you want to select and 
copy more than a word, double-click at 
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the beginning of the text but do not 
release the second click until you have 
dragged the mouse to the end of the 
region of text. Releasing the mouse 
triggers the macro and copies the 
selection into the find dialog. 


(Shift Command Period) Close top 
window, whatever it is. This is also 
equivalent to clicking the Cancel button 
when a dialog is in front. 
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SHIPPED MACROS 


The following is a list of shipped macros with a brief 
explanation of their function. 


Address List 

Extracts a list of addresses with either 5 or 9 digit zip codes, 
from the top file (or the search list). The list is copied to the 
current clipboard so you must clear that before using this. It 
begins at the cursor position (or the beginning of file if not 
opened) and ends at the end of the file. 


Appointments ‘ 

Use this macro to select today's appointments from the top file, 
copy them to a new file called "Appointments MM/DD/YY" 
where MM/DD/YY is today's date. For this macro to work 
properly you must have the Alarm Clock desk accessory and 
the clock must be set to the 12 hour option. All appointments 
must be typed in the following format: 


7:42:35 PM 6/1/89 Dinner with Bob and Helen. 


One appointment per line (or paragraph if you have page width 
set). The time and date must be in the format shown. 
<Returns> separate appointments. 


Archive Appointments 

Removes today's appointments from the top file and pastes 
them into the file called "Old Appointments" which must be in 
the current folder. 


Begin of line . 
Moves the cursor backwards to the beginning of the line. 


Begin of sentence 
Moves the cursor backwards to the beginning of the sentence. 


Char Swap ‘ 
Swaps the two characters to the right of the cursor. 


Clean Up DB ‘ ; 
Assumes each record is on one line, with commas separating 
fields. Removes all extra spaces. 
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Clean Up MS 

After saving Microsoft Word files as Text files, you can read 
them and edit them with QUED/M, however you may find odd 
“i.", “:” and “.c.” cluttering your text. These are used in 
Microsoft Word to designate indexed words and contents. This 


macro removes all such “garbage”. 


Clear Clipboards 
Clears all clipboards. 


Contents 

This macro extracts a table of contents from your file leaving it 
in the current clipboard. It identifies the chapter, section, and 
subsection by assuming they begin at the beginning of a line 
with a number. Of course this means that parts of text other 
than section titles could be picked up by this macro. 


Count Paragraphs 

Counts the number of <returns> (including the beginning of 
text) to determine the number of paragraphs. The dialog 
reports "The number of substitutions: 23". This is the count of 
paragraphs. No substitutions are actually made. 


Count Sentences 
Like Count Paragraphs above. 


Count Words 

Words are defined as "alphabetic" strings beginning in non 
alphabetic characters or the beginning of text. "Alphabetic" 
includes the single and double quotes. 


Create Directory 

Type into the current clipboard, (or "Copy") the name you want 
the directory (Folder) to be. Pull down this macro and if the 
directory does not exist, it will be created inside the current 
directory. 


Create Macro 

Use this to create a macro in the current macro file from a 
macro listing in the top window. The listing has to be in the 
same format as the Macro Listings File: The first line of each 
macro is the macro name. Then follow the lines of the macro. 
A blank line ends the macro and begins the next one. Use this 
macro repeatedly to re-create all the listed macros in the top file. 
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Cutout List 

Cuts out all lines (from the top file) which have text which 
matches the expression in Clipboard 9. All the cut text is in 
current clipboard. It is used by the Archive Appointments 
macro. 


Data Base Convert 

Converts data in the top file from one field per line (with a 
blank line as records separator) to one record per line with 
commas as field separators. Cleans up the file removing extra 
spaces and spaces at the ends and beginnings of fields. 
Removes all spaces on either side of the comma. 


Date 


Pastes the current date at the cursor position. 
Calendar Desk Accessory. 


Needs the 


Delete Macros 

Deletes macros from the current macro file, whose names are in 
the top file. This is a dangerous macro (if you select it by 
mistake). Have a back up copy of your macros or a listing. 


End of line 
Jumps to end of line. 


End of sentence 
Jumps to end of sentence. 


Extract Phone List 

Extracts names and phone numbers from the top file (or the file 
search list).The paragraph (or line with <return> at the .end) 
containing the phone number is copied. Before running this 
macro either open the address & notes file and make it the top 
file, or select the file or files and add them to the search list. 
The list is copied to clipboard 9, so it should be cleared first. 
Files in which a phone number is found are opened and left 
open. 


Extract References 

Uses the macro Get Ref. Copies all references from th= current 
(or search list) file which contain the text present in the current 
clipboard. Note that the manual instructs you to alter the macro 
to search for a particular reference. Whereas this is possible, 
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you can also simply type in the search expression into the 
current clipboard. If you want to edit the macro, you should 
change the expression \C9' in the first line of the macro Get 
Ref to the expression you wish to search, placing it inside 
double quotes. 


Extract State 

Assumes the name address, phone numbers and other 
information file is open or in the search list. The addresses 
should be typed as they would normally be on an envelope 
using the two letter state code. A blank line must separate each 
record. All the records for the state whose two letter code is in 
the current clipboard will be extracted and placed in clipboard 
9. Before you run this macro, Clear clipboard 9, place the 
relevant files in the search list, copy the two letter state code 
into the current clipboard. 


Extract Word List | 

Creates an alphabetized list of words from the current window. 
Places one word per line. Removes duplicate words. 
Removes plurals, adverbs, adjectives, single character words, 
and words with more than two consecutively repeated 
characters. The word list could be useful to you in creating 
your own dictionary of words you use. It could also be useful 
to check the number of unique words in your document. 


Find line wrap 
Finds an automatic line wrap (not a Return). 


From Data Base 

Converts a file with commas separating fields to one field per 
line. Any commas between quotes will be ignored. A blank 
line is inserted between records. The macro is not fool proof: if 
there is a quote of any kind on either side of a comma that 
comma is not replaced with a Return. 


Get Column 
This macro is used by the Sum Columns macro. It copies the 
numbers in a "column" to clipboard 9, 
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Get File List 

Copies to the current clipboard the full path to every file which 
is on the search list. Useful for creating the "Search List" 
which you can restore with the "Restore Search List" macro. 


Get List 

Copies to the current clipboard all the lines in the top file which 
contain the expression in Clipboard 9. Useful for extracting 
data about a "subject" from a text file. Make sure that the 
“subject” of the search is copied to clipboard 9, and that the 
current clipboard is not clipboard 9, 


Get Ref 

A looping macro used by Extract References which copies to 
clipboard 8 all the lines containing the text from the current 
clipboard. 


Hide All | 

This macro will "Hide" the text in each paragraph, separated 
from other text with blank lines. It Starts at the position of the 
I-beam and stops at the end of the file. 


Indent 
Indents (by one Tab) the beginnings of all lines which have no 
Return preceding them (i.e. wrapped lines). 


INITNEW 

This macro is automatically executed when you open a new 
file. It picks the Times size 12 font. You can change these by 
editing the macro. 


Last-First Back DB 

Swaps back to first name (or initial) first in a text data base. 
Reverses the effect of Last-First DB. Assumes each record is 
on one line, commas separating fields. 


Last-First DB 

Swaps the last and first names in a text data base of names and 
addresses. Fields are assumed Separated with commas, one 
record per line. Extra spaces are removed. 
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Last-First Swap 

Swaps the last name with the first name in a file where the first 
line of a record is the names line and where a blank line 
separates records. Removes extra spaces. 


List Search Files 
Assumes you have used “Add to Search List". Places the 
search files with full path to each, in the current clipboard. 


List Subject Files 

Copies to the current Clipboard a list of all the files (with full 
paths to each) containing the given word or phrase or 
"Subject". This subject of search (which can include the "OR" 
meta character "I") must be in the current clipboard and the files 
to be searched must be in the search list. 


Lower Case 

Converts the contents of the top file to lower case except for the 
beginnings of sentences. Proper names are also converted to 
lower case as there is no simple way to recognize those! 


Make Phone List 

Uses Extract Phone List to extract names and phone numbers 
from the top file and paste the list into a new file (which it 
opens) called "Phone List". The list is then alphabetized by last 
name. 


Merge List Check 

This macro needs to be customized by you, the user, before it 
can be used. It will extract from the top file all data lines which 
do not have four fields (separated with commas). This list of 
"Bad" lines it places in a new file called "Bad Data List" which 
it leaves as the top file. If you want to check for lines not 
having six records (rather than five), simply change the first 
expression in quotes in the macro from 


Felted te de (ple felt l*3tN\NElse\) to 
ete ln tele iret el tel els Se JAN Arlse\) 
That is, by adding one more expression ,[*,]+. You can 


reduce the correct number of fields by removing one or more of 
these expressions. 
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Name Order 

Sorts a list of names, where the firs name is first, by last name. 
Calls the macro “Paste Last” to swap the order of the first two 
words on each line, then sorts the list and swaps the order 
back. 


Non Zip Addresses 

Copies from the top file into the current clipboard, all the 
addresses (one line per address, commas separating fields) 
without either 5 or 9 digit zip codes. Although the file is 
changed during the macro, it ends up being the same at the end. 


Other Appointments 

Extracts all the appointments from the top file, for the date 
specified in the current clipboard, and copies them into a new 
file. Useful for finding out the appointments for some day in 
the future. If your appointments are already in time order in the 
Appointments file, you will not need this. 


Paste Last 

Swaps the order of the first two words on each line. Used for 
reordering the names (last to first) in a file of names and other 
things. 


Quotes Replace - 

Replaces all matched straight double and single quotes with the 
special opening double quotes “ and closing double quotes ” as 
well as the opening single quote ‘ and closing single quote’. It 
assumes that quoted expressions do not include a return 
character. 


Remove <cr> Selct 

Removes all return characters in the selected region and 
replaces them with spaces. Useful to combine lines into 
paragraphs especially in received E-mail. 


Remove Approx Repeats 

Useful for removing duplicate name and address records from a 
text data base, each record is assumed on one line, each field 
separated by commas. The macro checks if the first word on 
the line matches the following lines first word, and if the zip 
codes of the two lines match. You should first use the Zip 
Code Order macro to sort by zip code. The same zip code lines 
will then be ordered alphabetically. If you want to be safe and 


152 


check each approximate duplicate before removal, copy the 
regular expression (first quoted one in the macro) and paste it 
into the change dialog. Do the same with the second quoted 
expression into the "Change To" part. Then click "Find Next", 
check if appropriate then click the Change button. 


Remove Extra <cr> 
Removes all blank lines. 
Remove Phone Numbers rte % 
First removes all commas and blanks at the beginnings of lines 
then removes all sets of digits which could represent phone 
numbers. 


Remove Repeats * 
Removes all repeated neighboring lines. They have to be 
exactly the same. 


Restore Search List 


Assumes that the top file has a list of all the files (with full 


paths) to be added to the search list, one file per line. 


Save Search List 
Copies, to the current clipboard, the full path to each file on the 
search list (The same as the Get File List macro.) 


Sort Addresses 
Sort by the last name, addresses in the standard envelope 
format, with blank lines separating them. 


Sort Time 

Sorts lines beginning with the time and date in the format 
12:29:09 PM 6/8/99. The "seconds" part of the time is 
optional. Assumes a 12 hour clock. 


Sum column 

Sums a column of numbers. Places the sum to the right of the 
I-beam. Uses the calculator desk accessory which therefore 
must be available. 


Swap words 
Transposes words. 
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Time 


Pastes the current item at the cursor. Needs the Alarm Clock 
desk accessory. 


Time & Date 


Pastes the current time and date using the Alarm Clock desk 
Accessory. 


Word 2 
Copies all two character "words" into the clipboard 2. Change 


the number of dots (periods) inside the first quotes to reflect the 
number of characters you want, 


Zip Code Order 
Sorts a list of names and addresses (one line per address, 


ag separating the fields) by Zip Code. Uses Zip Code 
aster . 


Zip Code Paster 
Copies the Zip Code from the end of the line and pastes it at the 
beginning. Prepares the file for sorting by Zip Code. To cover 


the whole file you have to begin with the cursor at the start of 
the file. 


ZList All Macros 

Creates a list of all macros in clipboard 9 which it first clears. 
The first line of each macro listing is the name of the macro. 
Macros are separated by a blank line. You can use the "Create. 


Macro" macro to re-create macros one at a time, from a list in 
this format. 


ZList Macro Names 


Copies (from the currently loaded macro file) the list of macro 
names into the current clipboard. 
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The Paragon Update Procedure: 
The PUP™ Decryptor. 





Abstract 


This describes how to use the PUP Decryptor 
(distributed with our software) to update your software. 


(Instructions on how to use the PUP Encryptor are in 
a separate document distributed to the software 
publishers who purchase a site license.) 


rn eee SSS sped ee 
TERMINOLOGY 
The following defines our terminology. 


Any program file. (To be 
distinguished from the Document file which is an 
information file created by an application.) For example 
a word processor like MacWrite™ or InAWord™ is an 
Application file, whereas the files of your writings, 


created by MacWrite or InAWord are Document Files. 


Difference File The file created by the PUP 
Encryptor which contains the needed information (in 
an encrypted form using the Old File as the key) to 
(update) change the old file to the new file. 


Any information file created by an 


Document File 
application. For example a word processor (like 
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MacWrite or InAWord) creates document files which 
contain the text of your document. 


New File The updated program file. (The PUP 
Encryptor can also be used to encrypt document files. 
When used this way, the New File means the original 


or Decrypted document file.) 


Qld File This is the program file you wish to 
upgrade to the New File. 


PUP Decryptor The program which converts the 
Old File to the New File using the Difference file. 
This program is free and available on the . public 
networks and user groups. . 


Updated Program The Old File after it has been 
converted, ends up being a copy of the New File. 


INTRODUCTION. 


The PUP™ Decryptor is a special program which you 
Can use to update your software. 


Publishers generally keep improving their software. 
Unfortunately making these improvements available to 
you, the end user, is a costly enterprise. This cost has 
to be passed on to you. Therefore publishers usually 
charge you for updates. 


The Paragon Update Procedure (PUP™) was 
developed by Paragon Concepts Inc. to allow software 
publishers to distribute through public media (at a 
minimum cost to them and free to you, the end user) 
updates to all users having the original program. 


Using a program called the PUP Encryptor, the 
software publisher creates a Difference File which 
contains the necessary information to update the 
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Original program. This difference file the publisher 
distributes freely by using all possible means, such as 
dealers, public bulletin boards, and user groups. 


You, the legitimate owner of the old program can get 
a free copy of this difference file and the PUP 
Decryptor program from a user group, a bulletin 
board, a dealer, or a friend. You can then use the PUP 
Decryptor and the Difference File to convert your old 
program to the new, updated program. Since this 
Difference File is encrypted using the Old File as 
the key, the publisher can freely distribute it through all 
possible public channels getting it to you at minimum 
cost and in minimum time. 


™ YP 
In the following we describe in terms of an example, 
how to use the PUP Decryptor program to update an 
old program. 


Suppose you wanted to update the editor QUED™ 1.53 
to QUED™ 1.56. You will need the following: 

* A copy (do not use the original in case you make 
a mistake) of the original unchanged (the actual 
originally purchased disk) version of QUED™ 1.53 
(referred to here as the Old File). 

* A copy of the application PUP™ Decryptor. 

* A copy of the Difference File, ( QUED 1.53- 
>1.56 in this example.) 


Usually the original program file (QUED™ 1.53 in this 
example) cannot be the one you have been using, 
since it could have been altered. In the current 
example, making some changes in QUED 1.53, (such 
as adding transfer file names and then doing a "Save 
Defaults") will change the file. Generally other 
programs use resources to store user options. 
Whenever the user changes these options and saves 
them, the program's modification date is changed. If 
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this is the case, in order for the PUP Decryptor to work, 
you must use a copy of the original unaltered program 
file. 


The PUP Decryptor checks the modification date and 
will not work on files with incorrect dates. If you fool it 
by changing these dates, it may attempt a decryption, 
but the resulting program will crash. 


(Technical Note: The PUP Decryptor must have a file 
with the exact same resources as the unchanged 
original. The dates are the simplest, though not always 
foolproof indicator of whether the resources were 
changed.) 


The PUP™ Decryptor can be obtained from many user 
groups, bulletin boards and networks. Paragon 
Concepts Inc., also distributes it with their software. 


Copy the PUP™ Decryptor, the file you are to update 
(the QUED™ 1.53 file in this example) , and the 
Difference File (which in this example could be 
called QUED™ 1.53->1.56) on to a disk. 


Launch the PUP Decryptor by either opening it 
directly or by opening the PUP difference file (QUED™ 
1.53->1.56 in this example). - 


If you launched the PUP Decryptor directly (by 
double clicking its icon) open the difference file at the 
first file dialog (similar to the one shown in figure 1.). 


After the first announcement window you will see a user 
information dialog. This dialog displays information that 
the publisher has included for your benefit. It may 
include warnings, tips, advice or other information. 
Read it carefully. Choose "OK" to continue, or "Cancel" 
if you are not ready to create an updated version. 
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(2) puppy test 
NM OQUFD"' 1.53->1.56 


rey puppy test 


After you have clicked "OK" you will get the file dialog 
like the one shown in figure 2. Ry ; 
If you are ready, select and open the old file (i.e. the file 
to be updated), in this example QUED™ 1.53. 


(Technical Note: the files showing are restricted to 
those files whose creator, type, creation date, and 
modification date are the same as the released 
version.) 


If none of the files on that disk or folder are suitable, 
then none will be shown in the file dialog. If the file you 
want to update is not shown the following could be the 
reasons: 

* It is in a different directory; 

* It has been modified and so it cannot be used. 

¢ It is the wrong version for the particular differ- 
ence file. 


When you have found the correct old file, double click 
on it (or click on the “Open” button). 


You will get one last warning, like the one in figure 3, 
that the old file will be modified and changed to the new 
file. 
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puppy test 
-. QUED 1.53 > puppy test 


Select the copy of the old file. 









WARNING! Remember, the file 
*QUED 1.53" will actually be 
modified by the updating operation. 


Fig. 3. 


The Pup Decryptor will use the information in the 
difference file to modify the old file which then 
becomes the New File and so you have a new version 
of the program. Thus in this example the file called 
QUED™ 1.53 will be changed and renamed to 
QUED™ 1.56. (In general, whether the file is 
automatically renamed or not depends on the publisher 
distributing the difference file.) 


After the update is completed an alert will inform you of 
that. Press return, enter or click "OK". You will again be 
at the file selection dialog (the beginning of the 
program) from where you can quit or update another 
program. 
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